altova::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 |
|---|---|
DateTime() | Initialisiert eine neue Instanz der DateTime-Klasse auf 12:00:00 Mitternacht, 1. Jänner 0001. |
DateTime(__int64 value, short timezone) | Initialisiert eine neue Instanz der DateTime-Klasse. Der Parameter value repräsentiert die Anzahl der Zeiteinheiten (100-Nanosekunden-Intervalle), die seit 12:00:00 Mitternacht, 1. Jänner 0001 verstrichen sind. |
DateTime(int year, unsigned char month, unsigned char day, unsigned char hour, unsigned char minute, double second) | Initialisiert eine neue Instanz der DateTime-Klasse auf das als Argument bereitgestellte Jahr, den Monat, Tag, die Stunde, Minute und Sekunde.
|
DateTime(int year, unsigned char month, unsigned char day, unsigned char hour, unsigned char minute, double second, short timezone) | Initialisiert eine neue Instanz der DateTime-Klasse auf das als Argument bereitgestellte Jahr, den Monat, Tag, die Stunde, Minute, Sekunde und Zeitzone. Die Zeitzone wird in Minuten ausgedrückt und kann positiv oder negativ sein. So wird z.B. die Zeitzone "UTC-01:00" als "-60" ausgedrückt.
|
Methoden
Name | Beschreibung |
|---|---|
unsigned char Day() const | Gibt den Tag des Monats des aktuellen DateTime-Objekts zurück. Die Rückgabewerte liegen im Bereich von 1 bis 31. |
int DayOfYear() const | Gibt den Tag des Jahres des aktuellen DateTime-Objekts zurück. Die Rückgabewerte liegen im Bereich von 1 bis 366. |
bool HasTimezone() const | Gibt den Booleschen Wert true zurück, wenn für das aktuelle DateTime-Objekt eine Zeitzone definiert ist; gibt andernfalls false zurück. |
unsigned char Hour() const | Gibt die Stunde des aktuellen DateTime-Objekts zurück. Die Rückgabewerte liegen im Bereich von 0 bis 23. |
static bool IsLeapYear(int year) | Gibt den Booleschen Wert true zurück, wenn das Jahr der DateTime-Klasse ein Schaltjahr ist; gibt andernfalls false zurück. |
unsigned char Minute() const | Gibt die Minute des aktuellen DateTime-Objekts zurück. Die Rückgabewerte liegen im Bereich von 0 bis 59. |
unsigned char Month() const | Gibt den Monat des aktuellen DateTime-Objekts zurück. Die Rückgabewerte liegen im Bereich von 1 bis 12. |
__int64 NormalizedValue() const | Gibt den als Coordinated Universal Time (UTC) ausgedrückten Wert des aktuellen DateTime-Objekts zurück. |
double Second() const | Gibt die Sekunde des aktuellen DateTime-Objekts zurück. Die Rückgabewerte liegen im Bereich von 0 bis 59. |
void SetTimezone(short tz) | Setzt die Zeitzone des aktuellen DateTime-Objekts auf den als Argument bereigestellten Zeitzonenwert. Das Argument tz wird in Minuten ausgedrückt und kann positiv oder negativ sein. |
short Timezone() const | Gibt die Zeitzone des aktuellen DateTime-Objekts in Minuten zurück. Stellen Sie vor Verwendung dieser Methode durch Aufruf der HasTimezone()-Methode sicher, dass das Objekt tatsächlich eine Zeitzone hat. |
__int64 Value() const | Gibt den Wert des DateTime Objekts zurück, ausgedrückt in der Anzahl der Zeiteinheiten (100-Nanosekunden-Intervalle), die seit 12:00:00 Mitternacht, 1. Jänner 0001 verstrichen sind. |
int Weekday() const | Gibt den Wochentag des aktuellen DateTime-Objekts als Ganzzahl zurück. Die Werte liegen im Bereich von 0 bis 6, wobei 0 Montag ist (ISO-8601). |
int Weeknumber() const | Gibt den Nummer der Kalenderwoche des aktuellen DateTime-Objekts zurück. Die Werte entsprechen der ISO-8601-Norm. |
int WeekOfMonth() const | Gibt den Nummer der Woche des Monats des aktuellen DateTime-Objekts zurück. Die Werte entsprechen der ISO-8601-Norm. |
int Year() const | Gibt das Jahr des aktuellen DateTime-Objekts zurück. |
Beispiel
void Example() { // initialize a new DateTime instance to 12:00:00 midnight, January 1st, 0001 altova::DateTime dt1 = altova::DateTime();
// initialize a new DateTime instance using the year, month, day, hour, minute, and second altova::DateTime dt2 = altova::DateTime(2015, 11, 10, 9, 8, 7);
// initialize a new DateTime instance using the year, month, day, hour, minute, second, and UTC +01:00 timezone altova::DateTime dt = altova::DateTime(2015, 11, 22, 13, 53, 7, 60);
// Get the value of this DateTime object std::cout << "The number of ticks of the DateTime object is: " << dt.Value() << std::endl;
// Get the year cout << "The year is: " << dt.Year() << endl; // Get the month cout << "The month is: " << (int)dt.Month() << endl; // Get the day of the month cout << "The day of the month is: " << (int) dt.Day() << endl; // Get the day of the year cout << "The day of the year is: " << dt.DayOfYear() << endl; // Get the hour cout << "The hour is: " << (int) dt.Hour() << endl; // Get the minute cout << "The minute is: " << (int) dt.Minute() << endl; // Get the second cout << "The second is: " << dt.Second() << endl; // Get the weekday cout << "The weekday is: " << dt.Weekday() << endl; // Get the week number cout << "The week of year is: " << dt.Weeknumber() << endl; // Get the week in month cout << "The week of month is: " << dt.WeekOfMonth() << endl;
// Check whether a DateTime instance has a timezone if (dt.HasTimezone() == TRUE) { // output the value of the Timezone cout << "The timezone is: " << dt.Timezone() << endl; } else { cout << "No timezone has been defined." << endl; }
// Construct a DateTime object with a timezone UTC+01:00 (Vienna) altova::DateTime vienna_dt = DateTime(2015, 11, 23, 14, 30, 59, +60); // Output the result in readable format cout << "The Vienna time: " << (int) vienna_dt.Month() << "-" << (int) vienna_dt.Day() << " " << (int) vienna_dt.Hour() << ":" << (int) vienna_dt.Minute() << ":" << (int) vienna_dt.Second() << endl;
// Convert the value to UTC time DateTime utc_dt = DateTime(vienna_dt.NormalizedValue()); // Output the result in readable format cout << "The UTC time: " << (int) utc_dt.Month() << "-" << (int) utc_dt.Day() << " " << (int) utc_dt.Hour() << ":" << (int) utc_dt.Minute() << ":" << (int) utc_dt.Second() << endl;
// Check if a year is a leap year int year = 2016; if( altova::DateTime::IsLeapYear(year) ) { cout << year << " is a leap year" << endl; } else { cout << year << " is not a leap year" << endl; } } |