Isom.Base.Date

 ISOM/L-Bibliothek für Serviceautoren: <br />Isom.Base.Date

ISOM/L-Bibliothek
für Serviceautoren

Version 9.10.1.0 vom 25 November 2013

Namensraum Isom.Base.Date

Beschreibung

Isom.Base.Date stellt Funktionen für den Umgang mit Datums- und Zeitangaben bereit.



Funktionen

Isom.Base.Date.Clone

Erzeugt eine identische Kopie des Objekts.

objectbound Isom.Base.Date Isom.Base.Date.Clone  (  ) 

Erzeugt eine identische Kopie des Objekts.

Rückgabe:
Das geklonte Objekt.
Isom.Base.Date.ElapsedTime

Liefert die Zeitdifferenz in Sekunden zwischen diesem Zeitstempel und dem Vergleichswert.

objectbound Isom.Base.Number Isom.Base.Date.ElapsedTime  ( Isom.Base.Date  past  ) 

Liefert die Zeitdifferenz in Sekunden zwischen diesem Zeitstempel und dem Vergleichswert.

Die Zeitdifferenz ist positiv, falls der Vergleichswert in der Vergangenheit liegt, negativ sonst.

 Date timestamp = Date.Now(); 
 Date otherTimeStamp = ... 
 Number diff = timestamp.ElapsedTime(otherTimeStamp); 
Parameter:
past  Vergleichswert.
Rückgabe:
Zeitdifferenz in Sekunden zwischen diesem Zeitstempelobjekt und dem Vergleichswert.
Isom.Base.Date.IsVoid

Bestimmt, ob es sich um das Void-Objekt handelt.

objectbound Isom.Base.Boolean Isom.Base.Date.IsVoid  (  ) 

Bestimmt, ob es sich um das Void-Objekt handelt.

Rückgabe:
'true', falls dies das Void-Objekt ist, 'false' sonst.
Isom.Base.Date.Now

Abfrage eines Zeitstempelobjekts mit aktuellem Datum und Uhrzeit.

Isom.Base.Date Isom.Base.Date.Now  (  ) 

Abfrage eines Zeitstempelobjekts mit aktuellem Datum und Uhrzeit.

 Date timestamp = Date.Now(); 
Rückgabe:
Zeitstempelobjekt mit aktuellem Datum und Uhrzeit.
Isom.Base.Date.Parse

Erzeugt ein Zeitstempelobjekt für einen Zeitpunkt, der als Zeichenkette übergeben wird.

Isom.Base.Date Isom.Base.Date.Parse  ( Isom.Base.String  string  ) 

Erzeugt ein Zeitstempelobjekt für einen Zeitpunkt, der als Zeichenkette übergeben wird.

Die übergebene Zeichenkette wird nach ISO 8601:1988 interpretiert. Die Zeitangaben werden als Angaben in der koordinierten Weltzeit UTC (Universal Time Coordinated) ausgewertet.

Verwendungsbeispiel:
Mögliche Zeitangaben sind:

  • "13.02.2007"
  • "13.02.2007 15:00"
  • "15:00:00 13.02.2007"
  • "15:00"

Parameter:
string  Zeichenkette, die den Zeitpunkt angibt.
Rückgabe:
Zeitstempelobjekt.
Ausnahmebehandlung:
Es wird das Void-Objekt zurückgegeben, falls die übergebene Zeichenkette nicht interpretiert werden kann.
Isom.Base.Date.ParseFormatted

Erzeugt ein Zeitstempelobjekt auf Basis einer Formatierung, die als Parameter übergeben wird.

Isom.Base.Date Isom.Base.Date.ParseFormatted  ( Isom.Base.String  string,
Isom.Base.String  format,
Isom.Base.Boolean  local  )

Erzeugt ein Zeitstempelobjekt auf Basis einer Formatierung, die als Parameter übergeben wird.

Die Funktion unterstützt die Auswertung von Zeichenketten, die nicht in der Formatierung ISO 8601:1988 vorliegen. Die Angabe des Formats erfolgt wie bei der Funktion Isom.Base.Date.ToLocalTimeFormatted dokumentiert.

Parameter:
string  Zeichenkette, die den Zeitpunkt angibt.
format  Zeichenkette, das Format gemäß den Richtlinien von ISO 8601 vorgibt.
local  'true', wenn für die Datumsangabe lokale Zeit angenommen werden soll, 'false' bei UTC
Rückgabe:
Zeitstempelobjekt.
Ausnahmebehandlung:
Es wird das Void-Objekt zurückgegeben, falls die übergebene Zeichenkette nicht interpretiert werden kann.
Isom.Base.Date.ParseLocalTime

Erzeugt ein Zeitstempelobjekt für einen Zeitpunkt, der als Zeichenkette übergeben wird.

Isom.Base.Date Isom.Base.Date.ParseLocalTime  ( Isom.Base.String  string  ) 

Erzeugt ein Zeitstempelobjekt für einen Zeitpunkt, der als Zeichenkette übergeben wird.

Die Zeichenkette wird nach ISO 8601:1988 interpretiert. Die Zeitangaben werden als Angaben in der lokalen Zeit ausgewertet.

Verwendungsbeispiel:
Mögliche Zeitangaben sind:

  • "13.02.2007"
  • "13.02.2007 15:00"
  • "15:00:00 13.02.2007"
  • "15:00"

Parameter:
string  Zeichenkette, die den Zeitpunkt angibt.
Rückgabe:
Zeitstempelobjekt.
Ausnahmebehandlung:
Es wird das Void-Objekt zurückgegeben, falls die übergebene Zeichenkette nicht interpretiert werden kann.
Isom.Base.Date.ToLocalTime

Liefert eine lesbare Zeichenkette für diesen Zeitstempel, die der lokalen Systemzeit entspricht.

objectbound Isom.Base.String Isom.Base.Date.ToLocalTime  (  ) 

Liefert eine lesbare Zeichenkette für diesen Zeitstempel, die der lokalen Systemzeit entspricht.

Die Zeichenkette wird als "DD.MM.YYYY hh:mm:ss" formatiert. Ein Beispiel einer solchen Zeichenkette ist "13.02.2007 15:00:00".

 Date timestamp = Date.Now(); 
 String localTime = timestamp.ToLocalTime(); 
Rückgabe:
Zeitstempelobjekt.
Isom.Base.Date.ToLocalTimeFormatted

Liefert eine lesbare Zeichenkette für diesen Zeitstempel als Datum und Uhrzeit in der lokalen Systemzeit.

objectbound Isom.Base.String Isom.Base.Date.ToLocalTimeFormatted  ( Isom.Base.String  format  ) 

Liefert eine lesbare Zeichenkette für diesen Zeitstempel als Datum und Uhrzeit in der lokalen Systemzeit.

Für das Format werden die gleichen Zeichenketten verwendet, die der .NET Typ 'DateTime' akzeptiert. Die wichtigsten Standardformate sind:

StandardformatBeispiel
d 08/17/2000
g 08/17/2000 16:32
r Thu, 17 Aug 2000 23:32:32 GMT
s 2000-08-17T16:32:32
u 2000-08-17 23:32:32Z
U Thursday, August 17, 2000 23:32:32
Zusätzlich können eigene Formate aus den folgenden Zeichenketten zusammengestellt werden. Diese können mit anderen Zeichen kombiniert werden, wie am Ende der Tabelle gezeigt wird.
BenutzerformatBeschreibung / Beispiel
d der Tag des Monats (1-31)
dd der Tag des Monats (zweistellig: 01-31)
M der Monat (1-12)
MM der Monat (zweistellig: 01-12)
y das Jahr (0-99)
yy das Jahr (zweistellig: 0-99)
yyyy das Jahr (vierstellig)
h Stunde (1-12)
hh Stunde (zweistellig: 01-12)
tt AM/PM
H Stunde (0-23)
HH Stunde (zweistellig: 00-23)
m Minuten (0-59)
mm Minuten (zweistellig: 00-59)
s Sekunden (0-59)
ss Sekunden (zweistellig: 00-59)
z Zeitzonen-Offset in Stunden
zz Zeitzonen-Offset in Stunden (zweistellig)
zzz Zeitzonen-Offset in Stunden und Minuten
f Sekundenbruchteil (1. Stelle)
ff Sekundenbruchteil (zweistellig)
fff Sekundenbruchteil (dreistellig)
dd.MM.yyyy 23.03.2008
: Standardtrennzeichen für Uhrzeiten (meist ":")
\c c für beliebige c
HH\:mm\:ss 15:42:20
hh\:mm\:ss tt 03:42:20 p.m.
HH\:mm\:ss.fff 09:42:20.254
HH\:mm\:ss UTC Z 15:42:20 UTC +1

      Date timestamp = Date.Now(); 
      String utcTime = timestamp.ToLocalTimeFormatted("HH:mm:ss"); 
Parameter:
format  Das Format der Zeichenkette.
Rückgabe:
Zeitstempelobjekt.
Isom.Base.Date.ToUniversalTime

Liefert eine lesbare Zeichenkette für diesen Zeitstempel, die dem Datum und der Uhrzeit in UTC entspricht.

objectbound Isom.Base.String Isom.Base.Date.ToUniversalTime  (  ) 

Liefert eine lesbare Zeichenkette für diesen Zeitstempel, die dem Datum und der Uhrzeit in UTC entspricht.

Die Zeichenkette wird als "DD.MM.YYYY hh:mm:ss" formatiert. Ein Beispiel einer solchen Zeichenkette ist "13.02.2007 15:00:00".

 Date timestamp = Date.Now(); 
 String utcTime = timestamp.ToUniversalTime(); 
Rückgabe:
Zeitstempelobjekt.
Isom.Base.Date.ToUniversalTimeFormatted

Liefert eine lesbare Zeichenkette des Zeitstempels als Datum und Uhrzeit in UTC.

objectbound Isom.Base.String Isom.Base.Date.ToUniversalTimeFormatted  ( Isom.Base.String  format  ) 

Liefert eine lesbare Zeichenkette des Zeitstempels als Datum und Uhrzeit in UTC.

Beispiele für die Formatangabe finden sich in der Dokumentation zu ToLocalTimeFormatted(Isom.Base.String).

 Date timestamp = Date.Now(); 
 String utcTime = timestamp.ToUniversalTimeFormatted("HH:mm:ss"); 
Parameter:
format  Das Format der Zeichenkette.
Rückgabe:
Zeitstempelobjekt.
Isom.Base.Date.Void

Erzeugt ein ungültiges Objekt.

Isom.Base.Date Isom.Base.Date.Void  (  ) 

Erzeugt ein ungültiges Objekt.

Die Funktion kann in Fehlerfällen verwendet werden, um z.B. einen ungültigen Funktionsrückgabewert zu erzeugen.

Rückgabe:
Ungültiges Objekt.

Version 9.10.1.0 vom 25 November 2013