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