Datums- und Zeitformatzeichenfolgen

Formatzeichenfolgen werden als Vorlagen für die Umwandlung einer Zeichenfolge in ein Datum, eine Zeit oder einen DateTime-Wert, oder die Umwandlung eines Datums, einer Zeit oder eines DateTime-Wertes in eine Zeichenfolge verwendet. Die folgenden Tokens werden in der Formatzeichenfolge fmt interpretiert und verwendet, um die Teile eines Datums, einer Zeit oder eines DateTime-Wertes aus einer Zeichenfolge wie StringToDate und StringToDateTime zu lesen.

Datumsformate

Token Wert
yyyy Vierstelliges Jahr (z. B. 2012)
yy Zweistelliges Jahr (z. B. 12)
mmmm Vollständiger Monatsname (z. B. Januar)
mmm Abgekürzter Monatsname (z. B. Jan)
mm 1 Zweistelliger Monat (einschließlich ggf. führender Null). Januar = 01, Dezember = 12
m Ein- oder zweistelliger Monat (ohne führende Null). Januar = 1, Dezember = 12
dddd Vollständiger Name des Wochentages (z. B. Dienstag)
ddd Abgekürzter Name des Wochentages (z. B. Di)
dd Zweistelliger Tag des Monats (einschließlich ggf. führender Null). (z. B. 04)
d Ein- oder zweistelliger Tag des Monats (ohne führende Null). (z. B. 4)

Beim Aufrufen von DateToString enthält die Formatzeichenfolge fmt möglicherweise weitere Token und Zeichen, die unverändert an die resultierende Zeichenfolge weitergeleitet werden.

Beispiele mit Formatzeichenfolgen für Datumsangaben

Bei dem Datum Dienstag, 7. Oktober 2003 als Wert des Arguments date werden die angegebenen Ergebnisse durch die folgenden Aufrufe von DateToString erzeugt.


  DateToString(date, 'mm-dd-yy')           : 10-07-03
  DateToString(date, 'm-d-yyyy')           : 10-7-2003
  DateToString(date, 'dddd, mmmm d, yyyy') : Tuesday, October 7, 2003
  DateToString(date, 'Today is dddd')      : Today is Tuesday
			

Bei den gesamten folgenden Aufrufen von StringToDate wird ein Datumswert für den 7. Oktober 2003 erzeugt.


  StringToDate('10/7/2003', 'm/d/yyyy')
  StringToDate('10-07-03', 'm-dd-yy')
  StringToDate('Today is 2003-Oct-03', 'Today is yyyy-mmm-dd')
			

Zeitformate

Token Wert
hh Zweistellige Stunde (z. B. 09)
mm 1 Zweistellige Minute (z. B. 59)
ss Zweistellige Sekunde (z. B. 05)
tt AM oder PM (z. B. PM). Verwenden Sie ein einzelnes t für A oder P.
fff Bruchteile einer Sekunde auf bis zu drei Stellen (Millisekunden). Weitere Stellen werden abgeschnitten.

Geben Sie die Datums- und Zeitformatierung in Kleinbuchstaben an. Geben Sie beispielsweise hh statt HH an, um Stunden darzustellen.

Wenn eine DateTime-Spalte oder Time-Spalte allein in einem Ausdruck verwendet wird, wird sie anhand des vorliegenden Gebietsschemas formatiert.

Wenn es sich bei der DateTime- oder Time-Spalte um einen Ausdruck handelt, ist ihr Zeichenfolgenwert TimeToNumber oder DateToNumber + Leerzeichen + TimetoNumber.

Beispiele für Time- und DateTime-Formatzeichenfolgen

Bei der Zeit 10:50:30 Uhr als Wert des Arguments time werden die angegebenen Ergebnisse durch die folgenden Aufrufe von TimeToString und StringToTime erzeugt.


 TimeToString(time, 'hh:mm:ss tt')		        : 10:50:30 AM
 TimeToString(time, 'The time is hh:mm:ss tt')  : The time is 10:50:30 AM. 
 TimeToString(time, 'hh:mm:ss.fff tt")			: 10:50:30.333 AM
 StringToTime('10:50:30 AM', 'hh:mm:ss tt')
 StringToTime('The time is 10:50:30 AM', 'The time is hh:mm:ss tt')
 StringToTime('10:50:30.333 AM', 'hh:mm"ss.fff tt")
			

In den folgenden Beispielen wird ein Datum und eine Zeit für den 6. Juli 2012 um 10:50:30 Uhr in eine Zeichenfolge und einen DateTime-Wert umgewandelt.


StringToDateTime('07/06/2012 10:50:30 AM', 'mm/dd/yyyy hh:mm:ss tt')
DateTimeToString(StringToDateTime('07-06-2012 10:50:30 AM', 'mm-dd-yyyy hh:mm:ss tt'), 'mm-dd-yyyy hh:mm:ss tt')
1 Wenn sowohl Monate als auch Minuten verwendet werden, gilt das erste mm als der Monat. Eventuell sollten Sie die Datumsformatierung getrennt von der Zeitformatierung verwenden, damit es nicht zu Verwirrungen kommt.