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_method

DateTime(DateTime obj)

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

ic_method

DateTime(System.DateTime newvalue)

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

ic_method

DateTime(int year, int month, int day, int hour, int minute, double second, int offsetTZ)

Initialise une nouvelle instance de la classe DateTime à l’offset d’année, mois, jour, heure, minute, seconde et fuseau horaire fournis en tant qu’arguments.

ic_method

DateTime(int year, int month, int day, int hour, int minute, double second)

Initialise une nouvelle instance de la classe DateTime à l’année, mois, jour, heure, minute et seconde fournis en tant qu’arguments.

ic_method

DateTime(int year, int month, int day)

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

 

Propriétés


Nom

Description

ic_property

bool HasTimezone

Obtient une valeur Booléenne qui indique si DateTime a un fuseau horaire.

ic_property

static DateTime Now

Obtient un objet DateTime qui est défini sur la date et l’heure actuelles sur cet ordinateur.

ic_property

short TimezoneOffset

Obtient ou définit l’offset de fuseau horaire, en minutes de l’objet DateTime.

ic_property

System.DateTime Value

Obtient ou définit l’offset de l’objet DateTime en tant qu’une valeur System.DateTime.

 

Méthodes


Nom

Description

ic_method

int CompareTo(object obj)

La classe DateTime met en place l’interface IComparable. Cette méthode compare l’instance actuelle de DateTime avec un autre objet et retourne un entier qui indique si l’instance actuelle précèdes, suit, ou se produit dans la même position dans l’ordre de tri que l’autre objet. Voir aussi https://msdn.microsoft.com/en-us/library/system.icomparable.compareto(v=vs.110).aspx

ic_method

override bool Equals(object obj)

Retourne true si l’objet spécifié est égal à l’objet actuel ; false sinon.

ic_method

System.DateTime GetDateTime(bool correctTZ)

Retourne un objet System.DateTime depuis l’instance Altova.Types.DateTime. L’argument booléen correctTZ spécifie si le temps de l’objet retourné doit être ajusté conformément au fuseau horaire de l’instance actuel Altova.Types.DateTime.

ic_method

override int GetHashCode()

Retourne le code hash de l’instance actuelle.

ic_method

int GetWeekOfMonth()

Retourne le nombre de semaines dans le mois sous forme d’un entier.

ic_method

static DateTime Parse( string s )

Crée un objet DateTime depuis le string fournit en tant qu’argument. Par exemple, les valeurs de string d’échantillon suivantes sont converties avec succès dans un objet DateTime :

 

2015-01-01T23:23:23

01/01/2015

2015-11

23:23:23

 

Une exception est soulevée si le string ne peut pas être converti en un objet DateTime.

 
Veuillez noter que cette méthode est statique et qu’elle peut uniquement être appelée dans la classe Altova.Types.DateTime elle-même, pas dans une instance de la classe.

ic_method

static DateTime Parse(string s, DateTimeFormat format)

Crée un objet DateTime depuis un string, en utilisant le format fourni en tant qu’argument. Pour la liste des formats possibles, voir Altova.Types.DateTimeFormat.

 

Une exception est soulevée si le string ne peut pas être converti en un objet DateTime.

 
Veuillez noter que cette méthode est statique et qu’elle peut uniquement être appelée dans la classe Altova.Types.DateTime elle-même, pas dans une instance de la classe.

ic_method

override string ToString()

Convertit l’objet DateTime en un string.

ic_method

string ToString(DateTimeFormat format)

Convertit l’objet DateTime en un string, utiliser le format fournit en tant qu’argument. Pour la liste des formats possibles, voir Altova.Types.DateTimeFormat.

 

Opérateurs

Nom

Description

!=

Détermine si DateTime a n’est pas égal à DateTime b.

<

Détermine si DateTime a est inférieur à DateTime b.

<=

Détermine si DateTime a est inférieur ou égal à DateTime b.

==

Détermine si DateTime a est égal à DateTime b.

>

Détermine si DateTime a est supérieur à DateTime b.

>=

Détermine si DateTime a est supérieur ou égal à DateTime b.

 

Exemples

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

 

utiliser Altova.Types;

 

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

 

protected static void DateTimeExample1()
{
  // Create a DateTime object from the current system time
  Altova.Types.DateTime dt = new Altova.Types.DateTime(System.DateTime.Now);
  Console.WriteLine("The current time is: " + dt.ToString());
           
  // Create an Altova DateTime object from parts (no timezone)
  Altova.Types.DateTime dt1 = new Altova.Types.DateTime(2015, 10, 12, 10, 50, 33);
  Console.WriteLine("My custom time is : " + dt1.ToString());
 
  // Create an Altova DateTime object from parts (with UTC+60 minutes timezone)
  Altova.Types.DateTime dt2 = new Altova.Types.DateTime(2015, 10, 12, 10, 50, 33, 60);
  Console.WriteLine("My custom time with timezone is : " + dt2.ToString());
 
  // Create an Altova DateTime object by parsing a string
  Altova.Types.DateTime dt3 = Altova.Types.DateTime.Parse("2015-01-01T23:23:23");
  Console.WriteLine("Time created from string: " + dt3.ToString());
 
  // Create an Altova DateTime object by parsing a string formatted as schema date
  Altova.Types.DateTime dt4 = Altova.Types.DateTime.Parse("2015-01-01", DateTimeFormat.W3_date);
  Console.WriteLine("Time created from string formatted as schema date: " + dt4.ToString());
}

 

The following code listing illustrates various ways to format DateTime objects:

 

protected static void DateTimeExample2()
{
  // Create a DateTime object from the current system time
  Altova.Types.DateTime dt = new Altova.Types.DateTime(System.DateTime.Now);
 
  // Output the unformatted DateTime
  Console.WriteLine("Unformatted time: " + dt.ToString());
 
  // Output this DateTime formatted using various formats
  Console.WriteLine("S_DateTime:       " + dt.ToString(DateTimeFormat.S_DateTime));
  Console.WriteLine("S_Days:           " + dt.ToString(DateTimeFormat.S_Days));
  Console.WriteLine("S_Seconds:        " + dt.ToString(DateTimeFormat.S_Seconds));
  Console.WriteLine("W3_date:          " + dt.ToString(DateTimeFormat.W3_date));
  Console.WriteLine("W3_dateTime:      " + dt.ToString(DateTimeFormat.W3_dateTime));
  Console.WriteLine("W3_gDay:          " + dt.ToString(DateTimeFormat.W3_gDay));
  Console.WriteLine("W3_gMonth:        " + dt.ToString(DateTimeFormat.W3_gMonth));
  Console.WriteLine("W3_gMonthDay:     " + dt.ToString(DateTimeFormat.W3_gMonthDay));
  Console.WriteLine("W3_gYear:         " + dt.ToString(DateTimeFormat.W3_gYear));
  Console.WriteLine("W3_gYearMonth:    " + dt.ToString(DateTimeFormat.W3_gYearMonth));
  Console.WriteLine("W3_time:          " + dt.ToString(DateTimeFormat.W3_time));
}

© 2018-2024 Altova GmbH