Méthodes Datetime

Les méthodes ci-dessous sont les méthodes statiques système pour Datetime.

Nom Arguments Type de renvoi Description
newInstance Long l Datetime Construit une date/heure et l'initialise pour représenter le nombre de millisecondes spécifié depuis le 1er janvier 1970, 00:00:00 GMT. La date est renvoyée dans le fuseau horaire GMT.
newInstance Date Date

Time Time

 Datetime Construit une date/heure à partir des date et time spécifiées dans le fuseau horaire local. La date est renvoyée dans le fuseau horaire GMT.
newInstance Integer year

Integer month

Integer day

 Datetime Construit une date/heure à partir des représentations d'entier year, month (1=Jan) et day à minuit dans le fuseau horaire local. La date est renvoyée dans le fuseau horaire GMT.

Par exemple :

datetime myDate = 

   datetime.newInstance(2008, 12, 1);
newInstance Integer year

Integer month

Integer day

Integer hour

Integer minute

Integer second

 Datetime Construit une date/heure à partir des représentations d'entier de year, month (1=Jan), day, hour, minute et second dans le fuseau horaire local. La date est renvoyée dans le fuseau horaire GMT.

Par exemple :

Datetime myDate = 

datetime.newInstance(2008, 12, 1, 12, 30, 2);
newInstanceGmt Date date

Time time

 Datetime Construit une date/heure à partir des date et time spécifiées dans le fuseau horaire GMT.
newInstanceGmt Integer year

Integer month

Integer date

 Datetime Construit une date/heure à partir des représentations d'entier de year, month (1=Jan) et day à minuit dans le fuseau horaire GMT.
newInstanceGmt Integer year

Integer month

Integer date

Integer hour

Integer minute

Integer second

 Datetime Construit une date/heure à partir des représentations d'entier de year, month (1=Jan), day, hour, minute et second dans le fuseau horaire GMT.
now Datetime Renvoie la date/heure actuelle basée sur un calendrier GMT.

Par exemple :

datetime myDateTime = datetime.now();

Le format de la date/heure renvoyée est le suivant : 'MM/DD/YYYY HH:MM PERIOD'
parse String datetime Datetime Construit une date/heure à partir de la chaîne datetime dans le fuseau horaire local et en fonction des paramètres régionaux de l'utilisateur. La date est renvoyée dans le fuseau horaire GMT.
Cet exemple utilise parse pour créer une date/heure à partir d'une date passée sous forme de chaîne et mise en forme pour les paramètres régionaux Anglais (États-Unis). Vous devez modifier le format de la chaîne de date si vous avez des paramètres régionaux différents.
Datetime dt = DateTime.parse(

              '10/14/2011 11:46 AM');

String myDtString = dt.format();

system.assertEquals(

    myDtString,

    '10/14/2011 11:46 AM');
valueOf String s Datetime Renvoie une date/heure qui contient la valeur de la chaîne spécifiée. La chaîne doit utiliser le format de date standard « aaaa-MM-jj HH:mm:ss » dans le fuseau horaire local. La date est renvoyée dans le fuseau horaire GMT.

Par exemple :

string year = '2008';

string month = '10';

string day = '5';

string hour = '12';

string minute = '20';

string second = '20';

string stringDate = year + '-' + month

 + '-' + day + ' ' + hour + ':' + 

minute +  ':' + second;



Datetime myDate = 

   datetime.valueOf(stringDate);
valueOf Object fieldValue Datetime

Convertit la valeur du champ de suivi d'historique spécifiée en date/heure.

Utilisez cette méthode avec les champs OldValue ou NewValue de sObjects historiques, tels que AccountHistory, lorsque le champ est un champ de date/heure.

Exemple :

List<AccountHistory> ahlist = 

  [SELECT Field,OldValue,NewValue

   FROM AccountHistory];

for(AccountHistory ah : ahlist) {

  System.debug('Field: ' + ah.Field);

  if (ah.field == 'MyDatetime__c') {

    Datetime oldValue = 

      Datetime.valueOf(ah.OldValue);

    Datetime newValue = 

      Datetime.valueOf(ah.NewValue);

}
valueOfGmt String s Datetime Renvoie une date/heure qui contient la valeur de la chaîne spécifiée. La chaîne doit utiliser le format de date standard « aaaa-MM-jj HH:mm:ss » dans le fuseau horaire GMT.

Les méthodes ci-dessous sont les méthodes d'instance pour Datetime.

Nom Arguments Type de renvoi Description
addDays Integer addlDays Datetime Ajoute le nombre spécifié de addlDays à une date/heure. Par exemple :
datetime myDate = 

   datetime.newInstance

      (1960, 2, 17);

datetime newDate = mydate.addDays(2);
addHours Integer addlHours Datetime Ajoute le nombre spécifié de addlHours à une date/heure.
addMinutes Integer addlMinutes Datetime Ajoute le nombre spécifié de addlMinutes à une date/heure.
addMonths Integer addlMonths Datetime Ajoute le nombre spécifié de addlMonths à une date/heure.
addSeconds Integer addlSeconds Datetime Ajoute le nombre spécifié de addlSeconds à une date/heure.
addYears Integer addlYears Datetime Ajoute le nombre spécifié de addlYears à une date/heure.
date Date Renvoie le composant date d'une date/heure dans le fuseau horaire local de l'utilisateur actif.
dateGMT Date Renvoie le composant date d'une date/heure dans le fuseau horaire GMT.
day Integer Renvoie le composant date-du-mois d'une date/heure dans le fuseau horaire local de l'utilisateur actif. Par exemple, 5 février 1999 08:30:12 est jour 5.
dayGmt Integer Renvoie le composant date-du-mois d'une date/heure dans le fuseau horaire GMT. Par exemple, 5 février 1999 08:30:12 est jour 5.
dayOfYear Integer Renvoie le composant date-de-l'année d'une date/heure dans le fuseau horaire local de l'utilisateur actif. Par exemple, le 5 février 2008 08:30:12 est jour 36.
Datetime myDate = 

   datetime.newInstance

    (2008, 2, 5, 8, 30, 12);

system.assertEquals

    (myDate.dayOfYear(), 36);
dayOfYearGmt Integer Renvoie le composant date-de-l'année d'une date/heure dans le fuseau horaire GMT. Par exemple, 5 février 1999 08:30:12 est jour 36.
format String Convertit la date dans le fuseau horaire local et renvoie la date convertie sous forme de chaîne mise en forme en utilisant les paramètres régionaux de l'utilisateur actif. Si le fuseau horaire ne peut pas être déterminé, GMT est utilisé.
format String dateFormat String Convertit la date dans le fuseau horaire local et renvoie la date convertie sous forme de chaîne mise en forme en utilisant le format de date simple Java fourni. Si le fuseau horaire ne peut pas être déterminé, GMT est utilisé. Par exemple :
Datetime myDT = Datetime.now();

String myDate = myDT.format('h:mm a');
Pour plus d'informations sur le format de date simple Java, reportez-vous à Java SimpleDateFormat.
format String dateFormat

String timezone

 String Convertit la date dans le fuseau horaire spécifié et renvoie la date convertie sous forme de chaîne mise en forme en utilisant le format de date simple Java fourni. Si le format du fuseau horaire fourni est incorrect, GMT est utilisé.

Pour plus d'informations sur le format de date simple Java, reportez-vous à Java SimpleDateFormat.

Les valeurs de fuseau horaire correctes pour l'argument timezone sont les fuseaux horaires de la classe Java TimeZone qui correspondent aux fuseaux horaires renvoyés par la méthode TimeZone.getAvailableIDs dans Java. Nous recommandons d'utiliser les noms de fuseau horaire complets, pas les abréviations en trois lettres.

Cet exemple utilise format pour convertir une date GMT en fuseau horaire Amérique/New_York, et met en forme la date en utilisant le format de date spécifié.
Datetime GMTDate = 

  Datetime.newInstanceGmt(2011,6,1,12,1,5);

String strConvertedDate = 

  GMTDate.format('MM/dd/yyyy HH:mm:ss', 

                 'America/New_York');

// Date is converted to 

// the new time zone and is adjusted

// for daylight saving time.

System.assertEquals(

  '06/01/2011 08:01:05', strConvertedDate);
formatGmt StringdateFormat String Renvoie une date/heure sous forme de chaîne en utilisant le format de date simple Java fourni et le fuseau horaire GMT.

Pour plus d'informations sur le format de date simple Java, reportez-vous à Java SimpleDateFormat.
formatLong String Convertit la date dans le fuseau horaire local et renvoie la date convertie sous le format de date longue.

Par exemple :

// Passing local date based on the PST 

//   time zone

Datetime dt = DateTime.newInstance(

    2012,12,28,10,0,0);

// Writes 12/28/2012 10:00:00 AM PST

System.debug('dt.formatLong()=' 

    + dt.formatLong());
getTime Long Renvoie le nombre de millisecondes depuis le 1er janvier 1970, 00:00:00 GMT représenté par cet objet Date/heure.
hour Integer Renvoie le composant heure d'une date/heure dans le fuseau horaire local de l'utilisateur actif.
hourGmt Integer Renvoie le composant heure d'une date/heure dans le fuseau horaire GMT.
isSameDay Datetime compDt Boolean Renvoie true si la date/heure qui a appelé la méthode est identique à compDt dans le fuseau horaire local de l'utilisateur actif. Par exemple :
datetime myDate = datetime.now();

datetime dueDate = 

     datetime.newInstance(2008, 1, 30);

boolean dueNow = myDate.isSameDay(dueDate);
millisecond Integer Renvoie le composant milliseconde d'une date/heure dans le fuseau horaire local de l'utilisateur actif.
millisecondGmt Integer Renvoie le composant milliseconde d'une date/heure dans le fuseau horaire GMT.
minute Integer Renvoie le composant minute d'une date/heure dans le fuseau horaire local de l'utilisateur actif.
minuteGmt Integer Renvoie le composant minute d'une date/heure dans le fuseau horaire GMT.
month Integer Renvoie le composant mois d'une date/heure dans le fuseau horaire local de l'utilisateur actif (1=Jan).
monthGmt Integer Renvoie le composant mois d'une date/heure dans le fuseau horaire GMT (1=Jan).
second Integer Renvoie le composant seconde d'une date/heure dans le fuseau horaire local de l'utilisateur actif.
secondGmt Integer Renvoie le composant seconde d'une date/heure dans le fuseau horaire GMT.
time Time Renvoie le composant heure d'une date/heure dans le fuseau horaire local de l'utilisateur actif.
timeGmt Time Renvoie le composant heure d'une date/heure dans le fuseau horaire GMT.
year Integer Renvoie le composant année d'une date/heure dans le fuseau horaire local de l'utilisateur actif.
yearGmt Integer Renvoie le composant année d'une date/heure dans le fuseau horaire GMT.

Pour plus d'informations sur Datetime, reportez-vous à Types de données Primitive.

© Copyright 2000–2013 salesforce.com, inc. Tous droits réservés.
Diverses marques de commerce appartenant à leur détenteur respectif.