com.altova.types.DateTime
Mit Hilfe dieser Klasse können XML-Attribute oder -Elemente, die Datums- und Uhrzeittypen wie z.B. xs:dateTime haben, verarbeitet werden.
Konstruktoren
Name | Beschreibung | |
---|---|---|
public DateTime() | Initialisiert eine neue Instanz der DateTime-Klasse auf einen leeren Wert. | |
public DateTime(DateTime newvalue) | Initialisiert eine neue Instanz der DateTime-Klasse auf den als Argument bereitgestellten DateTime-Wert. | |
public DateTime(int newyear, int newmonth, int newday, int newhour, int newminute, int newsecond, double newpartsecond, int newoffsetTZ) | Initialisiert eine neue Instanz der DateTime-Klasse auf das Jahr, den Monat, den Tag, die Stunde, Minute, Sekunde, den Sekundenbruchteil und die Zeitzone, die als Argumente bereitgestellt wurden. Der Sekundenbruchteil newpartsecond muss zwischen 0 und 1 sein. Die Zeitzonendifferenz newoffsetTZ kann entweder positiv oder negativ sein und wird in Minuten ausgedrückt. | |
public DateTime(int newyear, int newmonth, int newday, int newhour, int newminute, int newsecond, double newpartsecond) | Initialisiert eine neue Instanz der DateTime-Klasse auf das Jahr, den Monat, den Tag, die Stunde, Minute, Sekunde und den Sekundenbruchteil, die als Argumente bereitgestellt wurden. | |
public DateTime(int newyear, int newmonth, int newday) | Initialisiert eine neue Instanz der DateTime-Klasse auf das Jahr, den Monat, den Tag, die als Argumente bereitgestellt wurden. | |
public DateTime(Calendar newvalue) | Initialisiert eine neue Instanz der DateTime-Klasse auf den als Argument bereitgestellten java.util.Calendar-Wert. |
Methoden
Name | Beschreibung | |||||||
---|---|---|---|---|---|---|---|---|
static DateTime now() | Gibt die aktuelle Uhrzeit als DateTime-Objekt zurück. | |||||||
static DateTime parse(String s) | Gibt ein DateTime-Objekt zurück, das aus dem als Argument bereitgestellten String-Werts geparst wird. Der folgende Beispiel-String würde erfolgreich in ein DateTime-Objekt konvertiert werden.
2015-11-24T12:54:47.969+01:00 2015-11-24T12:54:47 2015-11-24 | |||||||
int getDay() | Gibt den Tag der aktuellen DateTime-Instanz zurück. | |||||||
int getHour() | Gibt die Stunde der aktuellen DateTime-Instanz zurück. | |||||||
int getMillisecond() | Gibt die Millisekunde der aktuellen DateTime-Instanz als Ganzzahlwert zurück. | |||||||
int getMinute() | Gibt die Minute der aktuellen DateTime-Instanz zurück. | |||||||
int getMonth() | Gibt den Monat der aktuellen DateTime-Instanz zurück. | |||||||
double getPartSecond() | Gibt die Nachkommastellen der Sekunde der aktuellen DateTime-Instanz als double -Wert zurück. Der Rückgabewert ist größer als Null und kleiner als eins, z.B.:
0,313 | |||||||
int getSecond() | Gibt die Sekunde der aktuellen DateTime-Instanz zurück. | |||||||
int getTimezoneOffset() | Gibt den Zeitzonenunterschied zur aktuellen DateTime-Instanz in Minuten zurück. Die Zeitzone "UTC-01:00" würde z.B. als folgender Wert zurückgegeben:
-60 | |||||||
Calendar getValue() | Gibt die aktuelle DateTime Instanz als java.util.Calendar-Wert zurück. | |||||||
int getWeekday() | Gibt den Wochentag der aktuellen DateTime-Instanz zurück. Die Werte liegen im Bereich von 0 bis 6, wobei 0 Montag ist (ISO-8601). | |||||||
int getYear() | Gibt das Jahr der aktuellen DateTime-Instanz zurück. | |||||||
int hasTimezone() | Gibt Informationen über die Zeitzone der aktuellen DateTime-Instanz zurück. Mögliche Rückgabewerte sind:
| |||||||
void setDay( int nDay ) | Setzt den Tag der aktuellen DateTime-Instanz auf den als Argument bereitgestellten Wert. | |||||||
void setHasTimezone( int nHasTZ ) | Setzt die Zeitzoneninformation der aktuellen DateTime-Instanz auf den als Argument bereitgestellten Wert. Mit Hilfe dieser Methode können die Zeitzoneninformationen entfernt werden oder die Zeitzone kann auf UTC (Coordinated Universal Time) gesetzt werden. Gültige Werte für das nHasTZ-Argument:
| |||||||
void setHour( int nHour ) | Setzt die Stunde der aktuellen DateTime-Instanz auf den als Argument bereitgestellten Wert. | |||||||
void setMinute( int nMinute ) | Setzt die Minute der aktuellen DateTime-Instanz auf den als Argument bereitgestellten Wert. | |||||||
void setMonth( int nMonth ) | Setzt den Monat der aktuellen DateTime-Instanz auf den als Argument bereitgestellten Wert. | |||||||
void setPartSecond( double nPartSecond ) | Setzt die Sekundenbruchteile der aktuellen DateTime-Instanz auf den als Argument bereitgestellten Wert. | |||||||
void setSecond( int nSecond ) | Setzt die Sekunde der aktuellen DateTime-Instanz auf den als Argument bereitgestellten Wert. | |||||||
void setTimezoneOffset( int nOffsetTZ ) | Setzt den Zeitzonenunterschied der aktuellen DateTime-Instanz auf den als Argument bereitgestellten Wert. Der Wert nOffsetTZ muss eine (positive oder negative) Ganzzahl sein und in Minuten ausgedrückt werden. | |||||||
void setYear( int nYear ) | Setzt das Jahr der aktuellen DateTime-Instanz auf den als Argument bereitgestellten Wert. | |||||||
String toString() | Gibt die String-Darstellung der aktuellen DateTime-Instanz zurück, z.B.:
2015-11-24T15:50:56.968+01:00 |
Beispiele
Stellen Sie sicher, dass die Altova-Typen importiert wurden, bevor Sie die folgenden Codefragmente in Ihrem Programm verwenden.
import com.altova.types.*; |
In den folgenden Codefragmenten werden verschiedene Möglichkeiten zur Erstellung von DateTime-Objekten gezeigt:
protected static void DateTimeExample1() DateTime dt3 = DateTime.parse("2015-11-24T12:54:47.969+01:00"); |
Im folgenden Codefragment wird gezeigt, wie Werte aus DateTime-Objekte ermittelt werden:
protected static void DateTimeExample2() |
Im folgenden Codefragment wird gezeigt, wie der Zeitzonenunterschied eines DateTime-Objekts geändert wird:
protected static void DateTimeExample3() |