d$ = FormatDate(fmt$, date$[, isdst])
date$
übergebene Datum gemäß
der in fmt$
übergebenen Formatvorlage und gibt das Ergebnis
zurück. Dadurch können Sie Formatvorlagen für Datum und Uhrzeit,
die von GetLocaleInfo() zurückgegeben werden, in menschenlesbare
Datumsangaben umwandeln. Die in date$
übergebene Datumszeichenkette
muss in der von Hollywood verwendeten Standardnotation für Datum
und Uhrzeit vorliegen:
dd-mmm-yyyy hh:mm:ss |
Der dd
-Teil ist eine zweistellige Datumsangabe (mit führenden
Nullen) und der mmm
-Teil ist eine Zeichenkette mit drei Zeichen,
die den Monat angibt. Dies kann Jan
, Feb
, Mar
, Apr
, May
,
Jun
, Jul
, Aug
, Sep
, Oct
, Nov
oder Dec
sein. yyyy
ist
eine vierstellige Jahresangabe, während hh
die Stunden, mm
die Minuten und ss
die Sekunden angeben.
Die in date$
übergebene Datumsvorlage kann Zeichenkettenliterale
sowie die folgenden Token enthalten:
%a
%A
%b
%B
%d
%-d
%H
%-H
%I
%-I
%m
%-m
%M
%-M
%S
%-S
%y
%-y
%Y
Beachten Sie, dass abhängig von der Plattform, auf der Hollywood ausgeführt wird, möglicherweise einige weitere Token unterstützt werden, aber nur die oben aufgeführten funktionieren garantiert auf allen Plattformen.
Nur die oben aufgeführten Token werden in fmt$
ersetzt. Alle
anderen Token werden nicht ersetzt und verbleiben als Zeichenkettenliterale
in der zurückgegebenen Zeichenkette. Wenn Sie ein Prozentzeichen
als Zeichenkettenliteral in der Datumsvorlage haben möchten,
müssen Sie zwei Prozentzeichen (%%) angeben.
Das optionale Argument isdst
gibt an, ob an dem angegebenen
Datum die Sommerzeit aktiv ist oder nicht. Normalerweise müssen
Sie dieses Argument nicht angeben, da Hollywood diese Information
automatisch aus der Zeitzonendatenbank abfragt. Die Weitergabe
dieser Information ist nur dann notwendig, wenn die Zeitangabe
mehrdeutig ist, d.h. wenn bei der Umstellung von Sommerzeit
auf Winterzeit eine bestimmte Zeitspanne (normalerweise eine
Stunde) in der Nacht wiederholt wird. In Deutschland werden
beispielsweise die Uhren bei der Umstellung von Sommerzeit auf
Winterzeit von 3 Uhr morgens auf 2 Uhr morgens zurückgestellt.
Das bedeutet, dass die Stunde zwischen 2 Uhr und 3 Uhr morgens
zweimal vorkommt: Einmal in der Sommerzeit und einmal in der
Winterzeit (Normalzeit). Mit dem Argument isdst
können Sie
angeben, auf welche Stunde Sie sich beziehen.
d$ = FormatDate(GetLocaleInfo().DateTimeFormat, GetDate(#DATELOCAL)) DebugPrint(d$)Der obige Code gibt das Datum und die Uhrzeit entsprechend den Regeln des aktuellen Gebietsschemas formatiert aus.