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')