DATETIME( )-Funktion

  • Artikel

Gibt das aktuelle Datum und die aktuelle Uhrzeit als DateTime-Wert zurück.

DATETIME([nYear, nMonth, nDay [, nHours [, nMinutes [, nSeconds]]]])

Rückgabewerte

DatumZeit

Parameter

  • nYear
    Gibt das Jahr in einem Jahr 2000-verträglichen DateTime-Wert an. nYear kann Werte von 100 bis 9999 annehmen.
  • nMonth
    Gibt den Monat in einem Jahr 2000-verträglichen DateTime-Wert an. nMonth kann Werte von 1 bis 12 annehmen.
  • nDay
    Gibt den Tag in einem Jahr 2000-verträglichen DateTime-Wert an. nDay kann Werte von 1 bis 31 annehmen.
  • nHours
    Gibt die Stunden in einem Jahr 2000-verträglichen DateTime-Wert an. nHours kann Werte von 0 (Mitternacht) bis 23 (23 Uhr) annehmen. Standardwert ist 0, falls nicht angegeben.
  • nMinutes
    Gibt die Minuten in einem Jahr 2000-verträglichen DateTime-Wert an. nMinutes kann Werte von 1 bis 59 annehmen. Standardwert ist 0, falls nicht angegeben.
  • nSeconds
    Gibt die Sekunden in einem Jahr 2000-verträglichen DateTime-Wert an. nSekunden kann Werte von 0 bis 59 annehmen. Standardwert ist 0, falls nicht angegeben.

Hinweise

DATETIME( ) gibt das aktuelle Systemdatum zurück, wenn es ohne optionale Argumente aufgerufen wird. Wenn optionale Datumsparameter fehlen, werden diese durch aktuelle Systemwerte ersetzt. Wenn ein Zeitparameter fehlt, wird dieser durch 12:00:00 ersetzt.

Nehmen Sie die optionalen Argumente mit auf, wenn ein Jahr 2000-kompatibler DateTime-Wert in dem Format zurückgegeben werden soll, das im Visual FoxPro Dialogfeld "Optionen" auf der Registerkarte "Ländereinstellungen" angegeben wurde. Weitere Informationen zur Erstellung von Jahr 2000-kompatiblen DatumZeit-Werten finden Sie unter Datumsunterstützung für das Jahr 2000.

Beispiel

Dieses erste Beispiel speichert das Datum und die Uhrzeit des neuen Jahres in einer Variablen mit dem Namen tNewyear und das aktuelle Datum und die aktuelle Uhrzeit in einer Variablen mit dem Namen tToday. Anschließend wird die Anzahl der Sekunden, die zwischen den beiden Zeitpunkten liegt, angezeigt.

Das zweite Beispiel verwendet DATETIME(°) um ein Jahr 2000-verträglichen DateTime-Wert zu erzeugen.

tNewyear = DATETIME(YEAR(DATE( ) ) + 1, 1, 1)  && Next New Year
tToday = DATETIME()
nSecondstonewyear = tNewyear - tToday
CLEAR
? "There are " + ALLTRIM (STR(nSecondstonewyear)) ;
   + " seconds to the next New Year."

CLEAR
SET CENTURY ON
SET DATE TO AMERICAN
? DATETIME(1998, 02, 16, 12, 34, 56) && Displays 02/16/1998 12:34:56 PM

Siehe auch

CTOT( )-Funktion | DATE( )-Funktion | DTOT( )-Funktion HOUR( )-Funktion | SEC( )-Funktion | SECONDS( )-Funktion | SET SECONDS-Befehl | SET SYSFORMATS-Befehl | TIME( )-Funktion | TTOC( )-Funktion | TTOD( )-Funktion