Altova MapForce 2025 Professional Edition

Cette classe vous permet de traiter des attributs XML ou des éléments qui ont des types de date et d’heure, comme xs:dateTime.

 

Constructeurs


Nom

Description

ic_java_constructor

public DateTime()

Initialise une nouvelle instance de la classe DateTime dans une valeur vide.

ic_java_constructor

public DateTime(DateTime newvalue)

Initialise une nouvelle instance de la classe DateTime dans l’objet DateTime fourni en tant qu’argument.

ic_java_constructor

public DateTime(int newyear, int newmonth, int newday, int newhour, int newminute, int newsecond, double newpartsecond, int newoffsetTZ)

Initialise une nouvelle instance de la classe DateTime à l’année, mois, jour, heure, minute, seconde, la partie fractionnaire de la seconde et fuseau horaire fournis en tant qu’argument. La partie fractionnaire de la seconde newpartsecond doit se situer entre 0 et 1. L’offset de fuseau horaire newoffsetTZ peut être soit positif soit négatif et s’exprime en minutes.

ic_java_constructor

public DateTime(int newyear, int newmonth, int newday, int newhour, int newminute, int newsecond, double newpartsecond)

Initialise une nouvelle instance de la classe DateTime dans l’année, le mois, le jour, l’heure, la minute, la seconde et la partie fractionnelle d’une seconde fournie en tant qu’arguments.

ic_java_constructor

public DateTime(int newyear, int newmonth, int newday)

Initialise une nouvelle instance de la classe DateTime pour l’année, le mois et le jour fournis en tant qu’arguments.

ic_java_constructor

public DateTime(Calendar newvalue)

Initialise une nouvelle instance de la classe DateTime dans la valeur java.util.Calendar fournie en tant qu’argument.

 

Méthodes


Nom

Description

ic_java_public_static

static DateTime now()

Retourne l’heure actuelle en tant qu’un objet DateTime.

ic_java_public_static

static DateTime parse(String s)

Retourne un objet DateTime parsé depuis la valeur de string fournie en tant qu’argument. Par exemple, les valeurs de string d’échantillon suivantes sont converties avec succès dans un objet DateTime :

 

2015-11-24T12:54:47.969+01:00

2015-11-24T12:54:47

24/11/2015

ic_java_public_member

int getDay()

Retourne le jour de l’instance actuelle de DateTime.

ic_java_public_member

int getHour()

Retourne l’heure de l’instance actuelle de DateTime.

ic_java_public_member

int getMillisecond()

Retourne la milliseconde de l’instance actuelle de DateTime, en tant qu’une valeur d’entier.

ic_java_public_member

int getMinute()

Retourne la minute de l’instance actuelle DateTime.

ic_java_public_member

int getMonth()

Retourne le mois de l’instance actuelle DateTime.

ic_java_public_member

double getPartSecond()

Retourne la partie fractionnaire de la seconde de l’instance actuelle de DateTime, en tant que valeur double. La valeur de retour est supérieure à zéro et inférieure à un, par exemple :

 

0.313

ic_java_public_member

int getSecond()

Retourne la seconde de l’instance actuelle DateTime.

ic_java_public_member

int getTimezoneOffset()

Retourne l’offset de fuseau horaire, en minutes de l’instance actuelleDateTime. Par exemple, le fuseau horaire "UTC-01:00" serait retourné en tant que :

 

-60

ic_java_public_member

Calendar getValue()

Retourne l’instance actuelle de DateTime en tant qu’une valeur java.util.Calendar.

ic_java_public_member

int getWeekday()

Retourne le jour dans la semaine de l’instance actuelle DateTime. Les valeurs s’étendent de 0 à 6, 0 étant lundi (ISO-8601).

ic_java_public_member

int getYear()

Retoune l’année de l’instance actuelle DateTime.

ic_java_public_member

int hasTimezone()

Retourne l’information concernant le fuseau horaire de l’instance actuelle DateTime. Les valeurs de retour possibles sont :

CalendarBase.TZ_MISSING

Un offset de fuseau horaire n’est pas défini.

CalendarBase.TZ_UTC

Le fuseau horaire est UTC.

CalendarBase.TZ_OFFSET

Un offset de fuseau d’horaire a été défini.

ic_java_public_member

void setDay( int nDay )

Définit le jour de l’instance actuelle DateTime à la valeur fournie en tant qu’argument.

ic_java_public_member

void setHasTimezone( int nHasTZ )

Définit l’information de fuseau horaire de l’instance actuelle DateTime à la valeur fournie en tant qu’argument. Cette méthode peut être utilisée pour supprimer l’information de fuseau horaire ou définir le fuseau horaire sur UTC (Coordinated Universal Time). Les valeurs valides pour l’argument nHasTZ :

CalendarBase.TZ_MISSING

Configurer l’offset de fuseau horaire sur non-défini.

CalendarBase.TZ_UTC

Configurer le fuseau horaire sur UTC.

CalendarBase.TZ_OFFSET

Si l’objet actuel a un offset de fuseau horaire, ne pas le modifier.

ic_java_public_member

void setHour( int nHour )

Définit l’heure de l’instance actuelle DateTime à la valeur fournie en tant qu’argument.

ic_java_public_member

void setMinute( int nMinute )

Définit la minute de l’instance actuelle DateTime à la valeur fournie en tant qu’argument.

ic_java_public_member

void setMonth( int nMonth )

Définit le mois de l’instance actuelle DateTime à la valeur fournie en tant qu’argument.

ic_java_public_member

void setPartSecond( double nPartSecond )

Définit la partie fractionnaire de la seconde de l’instance actuelle DateTime à la valeur fournie en tant qu’argument.

ic_java_public_member

void setSecond( int nSecond )

Définit la seconde de l’instance actuelle DateTime à la valeur fournie en tant qu’argument.

ic_java_public_member

void setTimezoneOffset( int nOffsetTZ )

Définit l’offset de fuseau horaire de l’instance actuelle DateTime à la valeur fournie en tant qu’argument. La valeur nOffsetTZ doit être un entier (positif ou négatif) et doit être exprimée en minutes.

ic_java_public_member

void setYear( int nYear )

Définit l’année de l’instance actuelle DateTime à la valeur fournie en tant qu’argument.

ic_java_public_member

String toString()

Retourne la représentation de string de l’instance actuelle DateTime, par exemple :

 

2015-11-24T15:50:56.968+01:00

 

Exemples

Avant d’utiliser les extraits de code suivants dans votre programme, s’assurer que les types Altova sont importés :

 

import com.altova.types.*;

 

L’extrait de code suivant illustre plusieurs moyens de créer des objets DateTime :

 

protected static void DateTimeExample1()
{
  // Initialize a new instance of the DateTime class to the current time
  DateTime dt = new DateTime(DateTime.now());
  System.out.println("DateTime created from current date and time: " + dt.toString());
     
  // Initialize a new instance of the DateTime class by supplying the parts
  DateTime dt1 = new DateTime(2015, 11, 23, 14, 30, 24, .459);
  System.out.println("DateTime from parts (no timezone): " + dt1.toString());
 
  // Initialize a new instance of the DateTime class by supplying the parts
  DateTime dt2 = new DateTime(2015, 11, 24, 14, 30, 24, .459, -60);
  System.out.println("DateTime from parts (with negative timezone): " + dt2.toString());
     
  // Initialize a new instance of the DateTime class by parsing a string value        

  DateTime dt3 = DateTime.parse("2015-11-24T12:54:47.969+01:00");          
  System.out.println("DateTime parsed from string: " + dt3.toString());    
}      

 

The following code listing illustrates getting values from DateTime objects:

 

protected static void DateTimeExample2()
  {
    // Initialize a new instance of the DateTime class to the current time
    DateTime dt = new DateTime(DateTime.now());
       
    // Output the formatted year, month, and day of this DateTime instance
    String str1 = String.format("Year: %d; Month: %d; Day: %d;", dt.getYear(), dt.getMonth(), dt.getDay());
    System.out.println(str1);
       
    // Output the formatted hour, minute, and second of this DateTime instance
    String str2 = String.format("Hour: %d; Minute: %d; Second: %d;", dt.getHour(), dt.getMinute(), dt.getSecond());
    System.out.println(str2);
       
    // Return the timezone (in minutes) of this DateTime instance
    System.out.println("Timezone: " + dt.getTimezoneOffset());
       
    // Get the DateTime as a java.util.Calendar value
    java.util.Calendar dt_java = dt.getValue();
    System.out.println("" + dt_java.toString());
       
    // Return the day of week of this DateTime instance
    System.out.println("Weekday: " + dt.getWeekday());        
     
    // Check whether the DateTime instance has a timezone defined
    switch(dt.hasTimezone())
    {
        case CalendarBase.TZ_MISSING:
          System.out.println("No timezone.");
          break;
        case CalendarBase.TZ_UTC:            
          System.out.println("The timezone is UTC.");
          break;
        case CalendarBase.TZ_OFFSET:
          System.out.println("This object has a timezone.");
          break;
        default:
          System.out.println("Unable to determine whether a timezone is defined.");
          break;
    }      
  }

 

The following code listing illustrates changing the timezone offset of a DateTime object:

 

protected static void DateTimeExample3()
{      
  // Create a new DateTime object with timezone -0100 UTC
  DateTime dt = new DateTime(2015, 11, 24, 14, 30, 24, .459, -60);
  // Output the value before the change
  System.out.println("Before: " + dt.toString());
  // Change the offset to +0100 UTC
  dt.setTimezoneOffset(60);            
  // Output the value after the change
  System.out.println("After:  " + dt.toString());
}

© 2018-2024 Altova GmbH