DT_Format¶
DT_Format konvertiert eine Gleitkommazahl, die ein Datum enthält, in eine Zeichenkette.
- smRet = DT_Format(rmDate)
- smRet = DT_Format(rmDate, ssFormat)
Returnwert
smRet ist eine Matrix von Zeichenketten.
Parameter
- rmDate
rmDate ist eine reelle Matrix.
- ssFormat
ssFormat ist ein skalarer String mit eingebetteten Formatierungzeichen. Wird der Parameter ssFormat weggelassen, wird die Formatzeichenkette
"%c"verwendet. Formatierungszeichen für ssFormat:Wert
Bedeutung
%a
Abgekürzter Wochentagsname
%A
Wochentagsname
%B
Monatsname
%c
Datum und Zeit passend für aktuelle Ländereinstellungen
%d
Tag des Monats als Dezimalzahl (01 - 31)
%H
Stunde im 24-Stundenformat (00 - 23)
%I
Stunde im 12-Stundenformat (01 - 12)
%j
Tag des Jahres als Dezimalzahl (001 - 366)
%t
als Dezimalzahl (01 - 12)
%m
Monat als Dezimalzahl (1 - 12)
%M
Minute als Dezimalzahl (00 - 59)
%p
Aktueller Länder-A.M./P.M.-Indikator für 12-Stunden Uhr
%S
Sekunde als Dezimalzahl (00 - 59)
%U
Woche des Jahres, Sonntag erster Tag (00 - 51)
%w
Wochentag als Dezimalzahl (0 - 6; Sonntag ist 0)
%W
Woche des Jahres, Montag erster Tag (00 - 51)
%x
Datum für aktuelle Ländereinstellungen
%X
Zeit für aktuelle Ländereinstellungen
%y
Jahr ohne Jahrhundert als Dezimalzahl (00 - 99)
%Y
Jahr mit Jahrhundert als Dezimalzahl
%z, %Z
Zeitzonenname oder Abkürzung
%%
Prozentzeichen
##
Entferne führende Nullen (falls vorhanden) Beispiel: %#m
Kommentar
Der Parameter ssFormat besteht aus einem oder mehreren Formatierungszeichen. Wie bei der printf Funktion beginnt ein Formatierungszeichen mit einem Prozentzeichen (%). Buchstaben, die nicht mit einem Prozentzeichen beginnen werden ohne Änderung in die Rückgabezeichenkette kopiert. Die Ausgabe der Funktion ist von der Ländereinstellung abhängig.
Um beim "%c"-Format eine vierstellige Jahresangabe bei zu erhalten, muss in
der Ländereinstellung von Windows für die kurze Datumsangabe die Zeichenkette
TT.MM.JJJJ eingegeben werden.
Wie bei der printf Funktion hat das # Zeichen ein besondere Bedeutung:
%#a, %#A, %#b, %#B, %#p, %#X, %#z, %#Z, %#%: # flag wird ignoriert
%#c: Langes Datum/Zeitformat für die eingestellte Ländereinstellung.
Beispiel: "Tuesday, March 14, 1995, 12:41:29"
%#x:Langes Datum für die eingestellte Ländereinstellung.
Beispiel: "Tuesday, March 14, 1995"
%#d, %#H, %#I, %#j, %#m, %#M, %#S, %#U, %#w, %#W, %#y, %#Y: Führende Nullen werden entfernt (falls vorhanden).
Beispiel
* d = DT_GetCurrentTime()
* d
35992.3731
* DT_Format(d, "%c")
16.07.98 08:57:14
* DT_Format(d, "%#c")
Donnerstag, 16. Juli 1998 08:57:14
* DT_Format(d, "%x")
16.07.98
* DT_Format(d, "%X")
08:57:14
id-1118602