DateTimeFormatter

Paket	spark.formatters
Klasse	public class DateTimeFormatter
Vererbung	DateTimeFormatter GlobalizationBase AdvancedStyleClient EventDispatcher Object
Implementiert	IFormatter

Sprachversion:

ActionScript 3.0

Produktversion:

Flex 4.5

Laufzeitversionen:

Flash Player 10.1, AIR 2.5

Die DateTimeFormatter-Klasse stellt gebietsschemabeachtende Formatierung für ein Date-Objekt bereit.

Diese Klasse ist eine Wrapper-Klasse um die flash.globalization.DateTimeFormatter-Klasse. Die Funktion für die gebietsschemaspezifische Formatierung sowie die Namen der Monate und Tage und der erste Tag der Woche werden daher durch flash.globalization.DateTimeFormatter bereitgestellt. Diese DateTimeFormatter-Klasse, die in MXML-Deklarationen verwendet werden kann, verwendet jedoch den Stil des Gebietsschemas für die angeforderte Gebietsschema-ID und hat Methoden und Eigenschaften, die bindend sind.

Die flash.globalization.DateTimeFormatter-Klasse verwendet das zugrunde liegende Betriebssystem für die Formatierungsfunktion und für das Bereitstellen der gebietsschemaspezifischen Daten. Auf einigen Betriebssystemen werden die flash.globalization-Klassen nicht unterstützt. Auf diesen Systemen stellt diese Wrapper-Klasse Ersatzfunktionen bereit.

MXML-Syntax expanded

MXML-Syntax ausblenden

The <s:DateTimeFormatter> tag inherits all of the tag attributes of its superclass and adds the following tag attributes:

  <s:DateTimeFormatter
    Properties
    dateStyle="long"
    dateTimePattern="EEEE, MMMM dd, yyyy h:mm:ss a"
    errorText="null"
    timeStyle="long"
    useUTC="false"
  />

Beispiele anzeigen

Verwandte API-Elemente

flash.globalization.DateTimeFormatter

Öffentliche Eigenschaften

Vererbte öffentliche Eigenschaften ausblenden

Vererbte öffentliche Eigenschaften anzeigen

	Eigenschaft		Definiert von
		actualLocaleIDName : String [override] [schreibgeschützt] Der Name der Gebietsschema-ID, die von diesem Klassenobjekt verwendet wird.	DateTimeFormatter
		className : String [schreibgeschützt] Der Name der Komponentenklasse.	AdvancedStyleClient
		constructor : Object Ein Verweis auf das Klassenobjekt oder die Konstruktorfunktion für eine angegebene Objektinstanz.	Object
		dateStyle : String Der Datumsstil für diese DateTimeFormatter-Instanz.	DateTimeFormatter
		dateTimePattern : String Der Musterstring, der von diesem DateTimeFormatter-Objekt für die Formatierung von Datums- und Uhrzeitangaben verwendet wird.	DateTimeFormatter
		errorText : String String, der bei einem Fehler von der format()-Methode zurückgegeben wird.	DateTimeFormatter
		id : String Die Identität der Komponente.	AdvancedStyleClient
		inheritingStyles : Object Ein Objekt, das die vererbbaren Stile für diese nichtvisuelle Stilclientinstanz enthält.	AdvancedStyleClient
		lastOperationStatus : String [override] [schreibgeschützt] Der Status der letzten Operation, die dieses Klassenobjekt ausgeführt hat.	DateTimeFormatter
		moduleFactory : IFlexModuleFactory Eine Module-Factory wird als Kontext zum Suchen des Stilmanagers verwendet, der die Stile für diese nichtvisuelle Stilclientinstanz steuert.	AdvancedStyleClient
		nonInheritingStyles : Object Beginn der Kette von Komponentenstilen, die keine Vererbungsstile sind.	AdvancedStyleClient
		styleDeclaration : CSSStyleDeclaration Die Stildeklaration, die die von diesem Objekt deklarierten Inline-Stile enthält.	AdvancedStyleClient
		styleManager : IStyleManager2 [schreibgeschützt] Gibt die von dieser Komponente verwendete StyleManager-Instanz zurück.	AdvancedStyleClient
		styleName : Object Die Quelle der Stilwerte dieses Objekts.	AdvancedStyleClient
		styleParent : IAdvancedStyleClient Das übergeordnete Element einer Komponente wird zur Überprüfung der untergeordneten Selektoren verwendet.	AdvancedStyleClient
		timeStyle : String Der Uhrzeitstil für diese DateTimeFormatter-Instanz.	DateTimeFormatter
		useUTC : Boolean Ein boolesches Flag, das bestimmt, ob beim Formatieren eines Datums die Werte der Ortszeit und des lokalen Datums oder die Werte von UTC-Datum und -Zeit verwendet werden.	DateTimeFormatter

Öffentliche Methoden

Vererbte öffentliche Methoden ausblenden

Vererbte öffentliche Methoden anzeigen

	Methode		Definiert von
		DateTimeFormatter() Konstruiert ein neues DateTimeFormatter-Objekt, um Datum- und Uhrzeitangaben gemäß den Konventionen des angegebenen Gebietsschemas und den bereitgestellten Formatierungsstilen für Datum und Uhrzeit zu formatieren.	DateTimeFormatter
		addEventListener(type:String, listener:Function, useCapture:Boolean = false, priority:int = 0, useWeakReference:Boolean = false):void Registriert ein Ereignis-Listener-Objekt bei einem EventDispatcher-Objekt, sodass der Listener über ein Ereignis benachrichtigt wird.	EventDispatcher
		clearStyle(styleProp:String):void Löscht eine Stileigenschaft aus dieser Komponenteninstanz.	AdvancedStyleClient
		dispatchEvent(event:Event):Boolean Sendet ein Ereignis in den Ereignisablauf.	EventDispatcher
		format(value:Object):String Formatiert einen Anzeigestring für ein Objekt, das ein Datum angibt, entweder in der Ortszeit oder in UTC.	DateTimeFormatter
		getAvailableLocaleIDNames():Vector.<String> [statisch] Listet alle Gebietsschema-ID-Namen auf, die von dieser Klasse unterstützt werden.	DateTimeFormatter
		getClassStyleDeclarations():Array Gibt einen Array von CSSStyleDeclaration-Objekten für den Typselektor zurück, der auf diese Komponente anzuwenden ist, oder „null“, wenn keiner existiert.	AdvancedStyleClient
		getFirstWeekday():int Gibt eine Ganzzahl zurück, die dem ersten Tag der Woche für dieses Gebietsschema und dieses Kalendersystem entspricht.	DateTimeFormatter
		getMonthNames(nameStyle:String = "full", context:String = "standalone"):Vector.<String> Ruft eine Liste lokalisierter Strings mit den Monatsnamen für das aktuelle Kalendersystem ab.	DateTimeFormatter
		getStyle(styleProp:String):* [override] Ruft eine Stileigenschaft ab, die an einer beliebigen Stelle in der Stilkette der Komponente festgelegt ist.	GlobalizationBase
		getWeekdayNames(nameStyle:String = "full", context:String = "standalone"):Vector.<String> Ruft eine Liste lokalisierter Strings mit den Namen der Wochentage für das aktuelle Kalendersystem ab.	DateTimeFormatter
		hasCSSState():Boolean Gibt true zurück, wenn currentCSSState ungleich null ist.	AdvancedStyleClient
		hasEventListener(type:String):Boolean Überprüft, ob das EventDispatcher-Objekt Listener für einen bestimmten Ereignistyp registriert hat.	EventDispatcher
		hasOwnProperty(name:String):Boolean Gibt an, ob für ein Objekt eine bestimmte Eigenschaft definiert wurde.	Object
		initialized(document:Object, id:String):void Die initialized-Methode wird aufgerufen, wenn diese Klasse oder eine Klasse, die diese Klasse erweitert, in einer MXML-Deklaration verwendet wird.	AdvancedStyleClient
		isPrototypeOf(theClass:Object):Boolean Gibt an, ob eine Instanz der Object-Klasse in der Prototypkette des Objekts vorhanden ist, das als Parameter angegeben wurde.	Object
		matchesCSSState(cssState:String):Boolean Gibt „true“ zurück, wenn cssState mit currentCSSState übereinstimmt.	AdvancedStyleClient
		matchesCSSType(cssType:String):Boolean Bestimmt, ob diese Instanz dem angegebenen Typ entspricht oder eine Unterklasse davon ist.	AdvancedStyleClient
		notifyStyleChangeInChildren(styleProp:String, recursive:Boolean):void Gibt Stiländerungen an die untergeordneten Elemente dieser Stilclientinstanz weiter.	AdvancedStyleClient
		propertyIsEnumerable(name:String):Boolean Gibt an, ob die angegebene Eigenschaft vorhanden ist und durchlaufen werden kann.	Object
		regenerateStyleCache(recursive:Boolean):void Legt die internen Stilcachewerte fest, sodass die getStyle()-Methode funktioniert.	AdvancedStyleClient
		registerEffects(effects:Array):void Registriert den EffectManager als einen der Ereignis-Listener für jedes Effekt-Ereignis.	AdvancedStyleClient
		removeEventListener(type:String, listener:Function, useCapture:Boolean = false):void Entfernt einen Listener aus dem EventDispatcher-Objekt.	EventDispatcher
		setPropertyIsEnumerable(name:String, isEnum:Boolean = true):void Legt die Verfügbarkeit einer dynamischen Eigenschaft für Schleifenoperationen fest.	Object
		setStyle(styleProp:String, newValue:*):void Legt eine Stileigenschaft für diese Komponenteninstanz fest.	AdvancedStyleClient
		styleChanged(styleProp:String):void Erkennt Änderungen an Stileigenschaften.	AdvancedStyleClient
		stylesInitialized():void Flex ruft die stylesInitialized()-Methode auf, wenn die Stile für eine Komponente zum ersten Mal initialisiert werden.	AdvancedStyleClient
		toLocaleString():String Gibt die Stringdarstellung dieses Objekts zurück, formatiert entsprechend den Konventionen des Gebietsschemas.	Object
		toString():String Gibt das angegebene Objekt als String zurück.	Object
		valueOf():Object Gibt den Grundwert des angegebenen Objekts zurück.	Object
		willTrigger(type:String):Boolean Überprüft, ob bei diesem EventDispatcher-Objekt oder bei einem seiner Vorgänger ein Ereignis-Listener für einen bestimmten Ereignistyp registriert ist.	EventDispatcher

Ereignisse

Klicken Sie, um weitere Informationen zu Ereignissen zu erhalten.

Vererbte Ereignisse ausblenden

Vererbte Ereignisse anzeigen

	Übersicht	Definiert von
activate	[broadcast event] Wird ausgelöst, wenn Flash Player oder eine AIR-Anwendung den Betriebssystemfokus erhält und aktiv wird.	EventDispatcher
change	Das Änderungsereignis wird immer dann generiert, wenn der Gebietsschemastil geändert oder eine andere Eigenschaft festgelegt wird, die zur Änderung des Zahlenformats oder zu Updates der anderen durch diese Klasse bereitgestellten Werte führen würde.	GlobalizationBase
deactivate	[broadcast event] Wird ausgelöst, wenn Flash Player- oder die AIR-Anwendung den Fokus verliert und inaktiv wird.	EventDispatcher

Stile

Stile sind entweder allgemein oder mit einem bestimmten Thema verknüpft. Allgemeine Stile können mit jedem Thema verwendet werden. Stile, die mit einem bestimmten Thema verknüpft sind, können nur verwendet werden, wenn Ihre Anwendung dieses Thema verwendet.

Allgemeine Stile

Klicken Sie, um weitere Informationen zu Stilen zu erhalten.

Vererbte Stile ausblenden

Vererbte Stile anzeigen

	Stil		Beschreibung	Definiert von
		locale	Typ: String CSS-Vererbung: Ja Sprachversion: ActionScript 3.0 Produktversion: Flex 4.5 Laufzeitversionen: Flash10.1, AIR 2.5 Die Gebietsschema-ID, die die Tags und Schlüssel für Sprache, Region und Skript sowie optional weitere entsprechende Tags und Schlüssel angibt.	GlobalizationBase

Eigenschaftendetails

actualLocaleIDName

Eigenschaft

actualLocaleIDName:String [schreibgeschützt] [override]

Sprachversion:

ActionScript 3.0

Produktversion:

Flex 4.5

Laufzeitversionen:

Flash Player 10.1, AIR 2.5

Der Name der Gebietsschema-ID, die von diesem Klassenobjekt verwendet wird. Dies ist das Gebietsschema, das verwendet wird, um auf Formatierungsdaten und Funktionen vom Betriebssystem aus zuzugreifen.

Wenn das vom locale-Stil festgelegte Gebietsschema nicht verfügbar ist, sind der Wert des actualLocaleIDName und der Wert des locale-Stils unterschiedlich. Er gibt das Ersatzgebietsschema an, das verwendet wird. Wenn für den locale-Stil LocaleID.DEFAULT festgelegt wurde, wird der Name des vom Betriebssystem des Benutzers festgelegten Gebietsschemas verwendet.

Diese Eigenschaft kann als Quelle für die Datenbindung verwendet werden. Beim Ändern dieser Eigenschaft wird das change -Ereignis ausgelöst.

Implementierung
override public function get actualLocaleIDName():String

Verwandte API-Elemente

flash.globalization.DateTimeFormatter.actualLocaleIDName
DateTimeFormatter()

dateStyle

Eigenschaft

dateStyle:String

Sprachversion:

ActionScript 3.0

Produktversion:

Flex 4.5

Laufzeitversionen:

Flash Player 10.1, AIR 2.5

Der Datumsstil für diese DateTimeFormatter-Instanz. Der Datumsstil wird verwendet, um ein vordefiniertes für den Zeitpunkt und das Gebietsschema spezifisches Formatierungsmuster vom Betriebssystem abzurufen. Beim Formatieren eines Datums bestimmen der locale-Stil und die timeStyle- und dateStyle-Eigenschaften das Format des Datums. Der Wert für den Datumsstil kann auf zweierlei Weise festgelegt werden: durch Zuweisen eines Werts entweder zur dateStyle- oder zur dateTimePattern-Eigenschaft.

Die möglichen Werte dieser Eigenschaft werden von der flash.globalization.DateTimeStyle-Klasse definiert. Mögliche Werte für die dateStyle-Eigenschaft sind:

DateTimeStyle.LONG
DateTimeStyle.MEDIUM
DateTimeStyle.SHORT
DateTimeStyle.NONE
DateTimeStyle.CUSTOM

Wenn der dateTimePattern-Eigenschaft ein Wert zugewiesen wird, wird für die dateStyle-Eigenschaft DateTimeStyle.CUSTOM festgelegt.

Der Standardwert ist DateTimeStyle.LONG.

Diese Eigenschaft kann als Quelle für die Datenbindung verwendet werden. Beim Ändern dieser Eigenschaft wird das change -Ereignis ausgelöst.

Implementierung
public function get dateStyle():String
public function set dateStyle(value:String):void

Auslöser

	`ArgumentError` — wenn der zugewiesene Wert entweder keine gültige `DateTimeStyle`-Konstante oder `DateTimeStyle.CUSTOM` ist.

	`TypeError` — wenn der `dateStyle` oder den Wert `null` hat.

Verwandte API-Elemente

dateStyle
dateTimePattern
lastOperationStatus
flash.globalization.DateTimeStyle
DateTimeFormatter()

dateTimePattern

Eigenschaft

dateTimePattern:String

Sprachversion:

ActionScript 3.0

Produktversion:

Flex 4.5

Laufzeitversionen:

Flash Player 10.1, AIR 2.5

Der Musterstring, der von diesem DateTimeFormatter-Objekt für die Formatierung von Datums- und Uhrzeitangaben verwendet wird.

Es gibt zwei Möglichkeiten, dieses Muster festzulegen:

Durch Festlegen der dateStyle- und timeStyle-Eigenschaften.
Durch Festlegen der dateTimePattern-Eigenschaft.

Wenn dieser Eigenschaft direkt ein Wert zugewiesen wird, werden als Nebeneffekt die aktuellen Stile für Datum und Uhrzeit außer Kraft gesetzt und der DateTimeStyle.CUSTOM-Wert wird verwendet.

Eine Beschreibung der Mustersyntax finden Sie im Abschnitt zur flash.globalization.DateTimeFormatter.setDateTimePattern()-Methode.

Der Standardwert ist "EEEE, MMMM dd, yyyy h:mm:ss a".

Diese Eigenschaft kann als Quelle für die Datenbindung verwendet werden. Beim Ändern dieser Eigenschaft wird das change -Ereignis ausgelöst.

Implementierung
public function get dateTimePattern():String
public function set dateTimePattern(value:String):void

Verwandte API-Elemente

dateStyle
timeStyle

errorText

Eigenschaft

errorText:String

Sprachversion:

ActionScript 3.0

Produktversion:

Flex 4.5

Laufzeitversionen:

Flash Player 10.1, AIR 2.5

String, der bei einem Fehler von der format()-Methode zurückgegeben wird.

Wenn für errorText ein anderer Wert als „null“ festgelegt ist und während der Formatierung eines Datums ein Fehler auftritt, gibt die format-Methode den dieser Eigenschaft zugewiesenen String zurück.

Beispiel:

      var dtf:DateTimeFormatter = new DateTimeFormatter();
      dtf.setStyle("locale", "en-US");
      dtf.errorText = "----"
      trace(dtf.format("abc"));  // ----

Der Standardwert ist null.

Diese Eigenschaft kann als Quelle für die Datenbindung verwendet werden. Beim Ändern dieser Eigenschaft wird das change -Ereignis ausgelöst.

Implementierung
public function get errorText():String
public function set errorText(value:String):void

Verwandte API-Elemente

spark.globalization.LastOperationStatus

lastOperationStatus

Eigenschaft

lastOperationStatus:String [schreibgeschützt] [override]

Sprachversion:

ActionScript 3.0

Produktversion:

Flex 4.5

Laufzeitversionen:

Flash Player 10.1, AIR 2.5

Der Status der letzten Operation, die dieses Klassenobjekt ausgeführt hat. Die lastOperationStatus-Eigenschaft wird immer festgelegt, wenn der Konstruktor oder eine Methode dieser Klasse aufgerufen oder eine Eigenschaft festgelegt wird. Die möglichen Werte sind in der Beschreibung der einzelnen Methoden aufgeführt.

Diese Eigenschaft kann als Quelle für die Datenbindung verwendet werden. Beim Ändern dieser Eigenschaft wird das change -Ereignis ausgelöst.

Implementierung
override public function get lastOperationStatus():String

timeStyle

Eigenschaft

timeStyle:String

Sprachversion:

ActionScript 3.0

Produktversion:

Flex 4.5

Laufzeitversionen:

Flash Player 10.1, AIR 2.5

Der Uhrzeitstil für diese DateTimeFormatter-Instanz. Der Uhrzeitstil wird verwendet, um ein vordefiniertes für die Uhrzeit und das Gebietsschema spezifisches Formatierungsmuster vom Betriebssystem abzurufen. Beim Formatieren eines Datums bestimmen der locale-Stil und die timeStyle- und dateStyle-Eigenschaften das Format des Datums. Der Wert für den Datumsstil kann auf zweierlei Weise festgelegt werden: durch Zuweisen eines Werts entweder zur dateStyle- oder zur dateTimePattern-Eigenschaft.

Der Wert dieser Eigenschaft wird von der flash.globalization.DateTimeStyle-Klasse definiert. Mögliche Werte für die timeStyle-Eigenschaft sind:

DateTimeStyle.LONG
DateTimeStyle.MEDIUM
DateTimeStyle.SHORT
DateTimeStyle.NONE
DateTimeStyle.CUSTOM

Wenn der dateTimePattern-Eigenschaft ein Wert zugewiesen wird, wird für die dateStyle-Eigenschaft DateTimeStyle.CUSTOM festgelegt.

Der Standardwert ist DateTimeStyle.LONG.

Diese Eigenschaft kann als Quelle für die Datenbindung verwendet werden. Beim Ändern dieser Eigenschaft wird das change -Ereignis ausgelöst.

Implementierung
public function get timeStyle():String
public function set timeStyle(value:String):void

Auslöser

	`ArgumentError` — wenn der zugewiesene Wert entweder keine gültige `DateTimeStyle`-Konstante oder `DateTimeStyle.CUSTOM` ist.

	`TypeError` — wenn der `dateStyle`- oder `timeStyle`-Parameter null ist.

Verwandte API-Elemente

dateStyle
dateTimePattern
flash.globalization.DateTimeStyle
DateTimeFormatter()

useUTC

Eigenschaft

useUTC:Boolean

Sprachversion:

ActionScript 3.0

Produktversion:

Flex 4.5

Laufzeitversionen:

Flash Player 10.1, AIR 2.5

Ein boolesches Flag, das bestimmt, ob beim Formatieren eines Datums die Werte der Ortszeit und des lokalen Datums oder die Werte von UTC-Datum und -Zeit verwendet werden. Wenn für useUTC der Wert true festgelegt wird, werden die UTCWerte verwendet. Wird der Wert auf false festgelegt, werden die Datums- und Uhrzeitwerte der aktuellen Zeitzone des Betriebssystems verwendet.

Der Standardwert ist false.

Diese Eigenschaft kann als Quelle für die Datenbindung verwendet werden. Beim Ändern dieser Eigenschaft wird das change -Ereignis ausgelöst.

Implementierung
public function get useUTC():Boolean
public function set useUTC(value:Boolean):void

Verwandte API-Elemente

format()

Konstruktordetails

()

Konstruktor

public function DateTimeFormatter()

Sprachversion:

ActionScript 3.0

Produktversion:

Flex 4.5

Laufzeitversionen:

Flash Player 10.1, AIR 2.5

Konstruiert ein neues DateTimeFormatter-Objekt, um Datum- und Uhrzeitangaben gemäß den Konventionen des angegebenen Gebietsschemas und den bereitgestellten Formatierungsstilen für Datum und Uhrzeit zu formatieren.

Das Gebietsschema für diese Klasse wird vom Gebietsschemastil bereitgestellt. Der Gebietsschemastil kann auf verschiedene Weisen festgelegt werden:

Durch Verwenden der Klasse in einer MXML-Deklaration und Übernehmen des Gebietsschemas aus dem Dokument, das die Deklaration enthält.

      <fx:Declarations> 
             <s:DateTimeFormatter id="df" />
      </fx:Declarations>

Durch Verwenden einer MXML-Deklaration und Festlegen des Gebietsschemawerts in der Liste mit Zuweisungen.

      <fx:Declarations> 
          <s:DateTimeFormatter id="df_Japanese" locale="ja-JP" />
      </fx:Declarations>

Aufrufen der setStyle-Methode. Beispiel:
```
      df.setStyle("locale", "ja-JP")
```
Übernehmen des Stils aus einer UIComponent durch Aufruf der addStyleClient()-Methode der UIComponent.

Wenn der locale-Stil nicht durch eine der oben beschriebenen Methoden festgelegt wird, wird die Instanz dieser Klasse als StyleClient der topLevelApplication hinzugefügt und übernimmt daher den locale-Stil aus dem topLevelApplication-Objekt, wenn die locale-abhängige Get-Funktion oder locale-abhängige Methode aufgerufen wird.

Die meisten Eigenschaften dieser Klasse werden automatisch basierend auf dem Gebietsschemastil festgelegt. Wenn der Gebietsschemastil geändert wird, werden auch alle Eigenschaften, die nicht explizit festgelegt wurden, basierend auf dem neuen Gebietsschema aktualisiert. Beachten Sie, dass das verwendete Gebietsschema von der actualLocaleIDName-Eigenschaft festgelegt wird.

Verwandte API-Elemente

actualLocaleIDName
lastOperationsStatus

Methodendetails

format

()

Methode

public function format(value:Object):String

Sprachversion:

ActionScript 3.0

Produktversion:

Flex 4.5

Laufzeitversionen:

Flash Player 10.1, AIR 2.5

Formatiert einen Anzeigestring für ein Objekt, das ein Datum angibt, entweder in der Ortszeit oder in UTC.

Zu einem Date-Objekt gehören zwei Sätze aus Datums- und Zeitwerten: für die lokale Zeit des Benutzers (date, day, fullYear, hours, minutes, month und seconds) und in UTC-Zeit (dateUTC, dayUTC, fullYearUTC, hoursUTC, minutesUTC, monthUTC, und secondsUTC). Die Boolean-Eigenschaft useUTC steuert, welche Datums- und Zeitangaben bei der Formatierung verwendet werden. Für die Formatierung werden die Konventionen des Gebietsschemas verwendet, die durch die locale-Stileigenschaft und die dateStyle- und timeStyle-Eigenschaften oder durch das dateTimePattern bestimmt werden, das für diese DateTimeFormatter-Instanz festgelegt wurde.

Wenn aufgrund eines unzulässigen Eingabewerts oder anderen Fehlers ein Fehler beim Formatieren auftritt, gibt die format()-Methode standardmäßig null zurück. Wenn die errorText-Eigenschaft jedoch ungleich null ist, wird der Wert der errorText-Eigenschaft zurückgegeben. Die lastOperationStatus-Eigenschaft wird festgelegt, um den aufgetretenen Fehler anzugeben.

Parameter

value:Object — Ein zu formatierender Date-Wert. Wenn das Objekt kein Date ist, wird es mithilfe des Date()-Konstruktors in ein Datum konvertiert.

Rückgabewerte

String — Ein formatierter String, der den Wert für das Datum oder die Uhrzeit repräsentiert.

Verwandte API-Elemente

dateStyle
timeStyle
Datum
dateTimePattern
DateTimeFormatter

getAvailableLocaleIDNames

()

Methode

public static function getAvailableLocaleIDNames():Vector.<String>

Sprachversion:

ActionScript 3.0

Produktversion:

Flex 4.5

Laufzeitversionen:

Flash Player 10.1, AIR 2.5

Listet alle Gebietsschema-ID-Namen auf, die von dieser Klasse unterstützt werden. Dies ist eine Liste von Gebietsschemas, die vom Betriebssystem unterstützt werden. Dies ist keine Liste von Gebietsschemas, für die der ResourceManager Ressourcen hat.

Rückgabewerte

Vector.<String> — Ein Vektor von Strings, der alle von dieser Klasse und diesem Betriebssystem unterstützten Gebietsschema-ID-Namen enthält.

getFirstWeekday

()

Methode

public function getFirstWeekday():int

Sprachversion:

ActionScript 3.0

Produktversion:

Flex 4.5

Laufzeitversionen:

Flash Player 10.1, AIR 2.5

Gibt eine Ganzzahl zurück, die dem ersten Tag der Woche für dieses Gebietsschema und dieses Kalendersystem entspricht. Der Wert 0 entspricht Sonntag, 1 Montag usw., 6 entspricht Samstag.

Rückgabewerte

int — Eine Ganzzahl, die dem ersten Tag der Woche für dieses Gebietsschema und dieses Kalendersystem entspricht.

getMonthNames

()

Methode

public function getMonthNames(nameStyle:String = "full", context:String = "standalone"):Vector.<String>

Sprachversion:

ActionScript 3.0

Produktversion:

Flex 4.5

Laufzeitversionen:

Flash Player 10.1, AIR 2.5

Ruft eine Liste lokalisierter Strings mit den Monatsnamen für das aktuelle Kalendersystem ab. Das erste Element in der Liste ist der Name für den ersten Monat des Jahres.

Parameter

	`nameStyle:String` (default = "`full`") — Gibt den Stil des zu verwendenden Namensstring an. Gültige Werte sind: `DateTimeNameStyle.FULL` `DateTimeNameStyle.LONG_ABBREVIATION` `DateTimeNameStyle.SHORT_ABBREVIATION`

	`context:String` (default = "`standalone`") — Ein Code, der den Kontext angibt, in dem der formatierte String verwendet wird. Dieser Kontext ist nur bei bestimmten Gebietsschemas von Bedeutung. Gültige Werte sind: `DateTimeNameContext.FORMAT` `DateTimeNameContext.STANDALONE`

Rückgabewerte

Vector.<String> — Ein Vektor lokalisierter Strings, der die Monatsnamen für das aktuelle (durch den Gebietsschemastil festgelegte) Gebietsschema, den Namensstil und den Kontext enthält. Das erste Element im Vektor, bei der Indexposition 0, ist der Name des ersten Monats im Jahr; das nächste Element ist der Name des zweiten Monats im Jahr usw.

Auslöser

TypeError — wenn der nameStyle- oder context-Parameter null ist.

Verwandte API-Elemente

flash.globalization.DateTimeNameContext
flash.globalization.DateTimeNameStyle

getWeekdayNames

()

Methode

public function getWeekdayNames(nameStyle:String = "full", context:String = "standalone"):Vector.<String>

Sprachversion:

ActionScript 3.0

Produktversion:

Flex 4.5

Laufzeitversionen:

Flash Player 10.1, AIR 2.5

Ruft eine Liste lokalisierter Strings mit den Namen der Wochentage für das aktuelle Kalendersystem ab. Das erste Element in der Liste repräsentiert den Namen für Sonntag.

Parameter

	`nameStyle:String` (default = "`full`") — Gibt den Stil des zu verwendenden Namensstring an. Gültige Werte sind: `DateTimeNameStyle.FULL` `DateTimeNameStyle.LONG_ABBREVIATION` `DateTimeNameStyle.SHORT_ABBREVIATION`

	`context:String` (default = "`standalone`") — Ein Code, der den Kontext angibt, in dem der formatierte String verwendet wird. Dieser Kontext gilt nur für bestimmte Gebietsschemas, in denen der Name eines Monats sich je nach Kontext ändert. Im Griechischen ist der Monatsname zum Beispiel davon abhängig, ob er allein oder mit einem Tag angezeigt wird. Gültige Werte sind: `DateTimeNameContext.FORMAT` `DateTimeNameContext.STANDALONE`

Rückgabewerte

Vector.<String> — Ein Vektor lokalisierter Strings, der die Monatsnamen für das aktuelle (durch den Gebietsschemastil festgelegte) Gebietsschema, den Namensstil und den Kontext enthält. Das erste Element im Vektor, bei der Indexposition 0, ist der Name für Sonntag, das nächste Element ist der Name für Montag usw.

Auslöser

TypeError — wenn der nameStyle- oder context-Parameter null ist.

Verwandte API-Elemente

flash.globalization.DateTimeNameContext
flash.globalization.DateTimeNameStyle

Beispiele Verwendung dieses Beispiels

DateTimeFormatterExample.mxml

<?xml version="1.0" encoding="utf-8"?>
<!--  Sample program for spark.formatters.DateTimeFormatter -->
<s:Application
    xmlns:fx="http://ns.adobe.com/mxml/2009"
    xmlns:s="library://ns.adobe.com/flex/spark"
    xmlns:mx="library://ns.adobe.com/flex/mx">

    <fx:Declarations>
        <s:DateTimeFormatter id="dateTimeFormatter"/>
    </fx:Declarations>

    <fx:Script>
        <![CDATA[
            import mx.collections.ArrayCollection;

            private static const dateTimeStyleMenuItems:ArrayCollection
                = new ArrayCollection(["long", "medium", "short", "none"]);
        ]]>
    </fx:Script>

    <mx:Form>
        <mx:FormItem label="Input Locale ID Name">
            <mx:HBox>
                <s:TextInput id="inputLocaleIDName"/>
                <!-- Upon button click, sets the locale style on the document
                    UI component. The formatter will inherit this style. -->
                <s:Button click="setStyle('locale', inputLocaleIDName.text);"
                          label="Apply"/>
            </mx:HBox>
            <mx:Text text="Example: 'en-US', 'fr-FR', 'ja-JP', 'ar-SA'"/>
        </mx:FormItem>
        <mx:FormItem label="Date Style">
            <s:DropDownList id="dateStyle" requireSelection="true"
                change="dateTimeFormatter.dateStyle = dateTimeStyleMenuItems[dateStyle.selectedIndex]"
                dataProvider="{dateTimeStyleMenuItems}"/>
        </mx:FormItem>
        <mx:FormItem label="Time Style">
            <s:DropDownList id="timeStyle" requireSelection="true"
                change="dateTimeFormatter.timeStyle = dateTimeStyleMenuItems[timeStyle.selectedIndex]"
                dataProvider="{dateTimeStyleMenuItems}"/>
        </mx:FormItem>
        <mx:FormItem label="Input Date">
            <mx:TextInput id="inputDate" text="{new Date().toString()}"/>
        </mx:FormItem>
        <mx:FormItem label="Actual Locale ID Name">
            <mx:Text text="{dateTimeFormatter.actualLocaleIDName}"/>
        </mx:FormItem>
        <mx:FormItem label="Formatted Result">
            <mx:Text id="uiFormattedDate"
                text="{dateTimeFormatter.format(inputDate.text)}"/>
        </mx:FormItem>
    </mx:Form>
</s:Application>

Rechtliche Hinweise | Onlinedatenschutzerklärung

DateTimeFormatter - AS3 Flex

Klassen x

actualLocaleIDName

dateStyle

dateTimePattern

errorText

lastOperationStatus

timeStyle

useUTC