--- schema_version: "1" id: 432ae013f1b2a0c01969fa40352290e63e0b855833e77517dded8c815bb41e81 title: Datetime Class collection: legacydeveloper version: current locale: en-us portal_url: https://docs.salesforce.com/legacydeveloper/current/en-us/apexref/apex_methods_system_datetime.md canonical_url: https://developer.salesforce.com/docs/atlas.en-us.apexref.meta/apexref/apex_methods_system_datetime.htm source_site: developer.salesforce.com content_type: documentation content_hash: ecbc9b7fde7130c2d1d32e2a5ecbd4f70f28913e4976f9b30117177b959b4553 description: Contains methods for the Datetime primitive data type.Adds the specified number of days to a Datetime.Adds the specified number of hours to a Datetime.Adds the specified number of minutes to a Datetime.Adds the specified number of months to a Datetime.Adds the specified number of seconds to a Datetime.Adds the specified number of years to a Datetime.Returns the Date component of a Datetime in the local time zone of the context user. Return the Date component of a Datetime in the GMT time zone.Returns the day-of-month component of a Datetime in the local time zone of the context user.Returns the day-of-month component of a Datetime in the GMT time zone.Returns the day-of-year component of a Datetime in the local time zone of the context user.Returns the day-of-year component of a Datetime in the GMT time zone.Converts the date to the local time zone and returns the converted date as a formatted string using the locale of the context user. If the time zone cannot be determined, GMT is used.Converts the date to the local time zone and returns the converted date as a string using the supplied Java simple date format. If the time zone cannot be determined, GMT is used.Converts the date to the specified time zone and returns the converted date as a string using the supplied Java simple date format. If the supplied time zone is not in the correct format, GMT is used.Returns a Datetime as a string using the supplied Java simple date format and the GMT time zone.Converts the date to the local time zone and returns the converted date in long date format.Returns the number of milliseconds since January 1, 1970, 00:00:00 GMT represented by this DateTime object.Returns the hour component of a Datetime in the local time zone of the context user.Returns the hour component of a Datetime in the GMT time zone.Returns true if the Datetime that called the method is the same as the specified Datetime in the local time zone of the context user.Return the millisecond component of a Datetime in the local time zone of the context user.Return the millisecond component of a Datetime in the GMT time zone.Returns the minute component of a Datetime in the local time zone of the context user.Returns the minute component of a Datetime in the GMT time zone.Returns the month component of a Datetime in the local time zone of the context user (1=Jan).Returns the month component of a Datetime in the GMT time zone (1=Jan).Constructs a Datetime and initializes it to represent the specified number of milliseconds since January 1, 1970, 00:00:00 GMT.Constructs a DateTime from the specified date and time in the local time zone.Constructs a Datetime from Integer representations of the specified year, month (1=Jan), and day at midnight in the local time zone.Constructs a Datetime from Integer representations of the specified year, month (1=Jan), day, hour, minute, and second in the local time zone.Constructs a DateTime from the specified date and time in the GMT time zone. Constructs a Datetime from Integer representations of the specified year, month (1=Jan), and day at midnight in the GMT time zoneConstructs a Datetime from Integer representations of the specified year, month (1=Jan), day, hour, minute, and second in the GMT time zoneReturns the current Datetime based on a GMT calendar. Constructs a Datetime from the given String in the local time zone and in the format of the user locale. Returns the second component of a Datetime in the local time zone of the context user.Returns the second component of a Datetime in the GMT time zone.Returns the time component of a Datetime in the local time zone of the context user.Returns the time component of a Datetime in the GMT time zone.Returns a Datetime that contains the value of the specified string.Converts the specified object to a Datetime. Use this method to convert a history tracking field value or an object that represents a Datetime value.Returns a Datetime that contains the value of the specified String.Returns the year component of a Datetime in the local time zone of the context user.Returns the year component of a Datetime in the GMT time zone. --- # Datetime Class Contains methods for the Datetime primitive data type. ## Namespace [System](https://developer.salesforce.com/docs/atlas.en-us.apexref.meta/apexref/apex_namespace_System.htm "The System namespace provides classes and methods for core Apex functionality.") ## Usage Apex supports both implicit and explicit casting of Date values to Datetime, with the time component being zeroed out in the resulting Datetime value. For more information about the Datetime, see [Datetime Data Type](https://developer.salesforce.com/docs/atlas.en-us.264.0.apexcode.meta/apexcode/langCon_apex_primitives.htm). ## Datetime Methods The following are methods for Datetime. - **[addDays(additionalDays)](https://developer.salesforce.com/docs/atlas.en-us.apexref.meta/apexref/apex_methods_system_datetime.htm#apex_System_Datetime_addDays)** Adds the specified number of days to a Datetime. - **[addHours(additionalHours)](https://developer.salesforce.com/docs/atlas.en-us.apexref.meta/apexref/apex_methods_system_datetime.htm#apex_System_Datetime_addHours)** Adds the specified number of hours to a Datetime. - **[addMinutes(additionalMinutes)](https://developer.salesforce.com/docs/atlas.en-us.apexref.meta/apexref/apex_methods_system_datetime.htm#apex_System_Datetime_addMinutes)** Adds the specified number of minutes to a Datetime. - **[addMonths(additionalMonths)](https://developer.salesforce.com/docs/atlas.en-us.apexref.meta/apexref/apex_methods_system_datetime.htm#apex_System_Datetime_addMonths)** Adds the specified number of months to a Datetime. - **[addSeconds(additionalSeconds)](https://developer.salesforce.com/docs/atlas.en-us.apexref.meta/apexref/apex_methods_system_datetime.htm#apex_System_Datetime_addSeconds)** Adds the specified number of seconds to a Datetime. - **[addYears(additionalYears)](https://developer.salesforce.com/docs/atlas.en-us.apexref.meta/apexref/apex_methods_system_datetime.htm#apex_System_Datetime_addYears)** Adds the specified number of years to a Datetime. - **[date()](https://developer.salesforce.com/docs/atlas.en-us.apexref.meta/apexref/apex_methods_system_datetime.htm#apex_System_Datetime_date)** Returns the Date component of a Datetime in the local time zone of the context user. - **[dateGMT()](https://developer.salesforce.com/docs/atlas.en-us.apexref.meta/apexref/apex_methods_system_datetime.htm#apex_System_Datetime_dateGMT)** Return the Date component of a Datetime in the GMT time zone. - **[day()](https://developer.salesforce.com/docs/atlas.en-us.apexref.meta/apexref/apex_methods_system_datetime.htm#apex_System_Datetime_day)** Returns the day-of-month component of a Datetime in the local time zone of the context user. - **[dayGmt()](https://developer.salesforce.com/docs/atlas.en-us.apexref.meta/apexref/apex_methods_system_datetime.htm#apex_System_Datetime_dayGmt)** Returns the day-of-month component of a Datetime in the GMT time zone. - **[dayOfYear()](https://developer.salesforce.com/docs/atlas.en-us.apexref.meta/apexref/apex_methods_system_datetime.htm#apex_System_Datetime_dayOfYear)** Returns the day-of-year component of a Datetime in the local time zone of the context user. - **[dayOfYearGmt()](https://developer.salesforce.com/docs/atlas.en-us.apexref.meta/apexref/apex_methods_system_datetime.htm#apex_System_Datetime_dayOfYearGmt)** Returns the day-of-year component of a Datetime in the GMT time zone. - **[format()](https://developer.salesforce.com/docs/atlas.en-us.apexref.meta/apexref/apex_methods_system_datetime.htm#apex_System_Datetime_format)** Converts the date to the local time zone and returns the converted date as a formatted string using the locale of the context user. If the time zone cannot be determined, GMT is used. - **[format(dateFormatString)](https://developer.salesforce.com/docs/atlas.en-us.apexref.meta/apexref/apex_methods_system_datetime.htm#apex_System_Datetime_format_2)** Converts the date to the local time zone and returns the converted date as a string using the supplied Java simple date format. If the time zone cannot be determined, GMT is used. - **[format(dateFormatString, timezone)](https://developer.salesforce.com/docs/atlas.en-us.apexref.meta/apexref/apex_methods_system_datetime.htm#apex_System_Datetime_format_3)** Converts the date to the specified time zone and returns the converted date as a string using the supplied Java simple date format. If the supplied time zone is not in the correct format, GMT is used. - **[formatGmt(dateFormatString)](https://developer.salesforce.com/docs/atlas.en-us.apexref.meta/apexref/apex_methods_system_datetime.htm#apex_System_Datetime_formatGmt)** Returns a Datetime as a string using the supplied Java simple date format and the GMT time zone. - **[formatLong()](https://developer.salesforce.com/docs/atlas.en-us.apexref.meta/apexref/apex_methods_system_datetime.htm#apex_System_Datetime_formatLong)** Converts the date to the local time zone and returns the converted date in long date format. - **[getTime()](https://developer.salesforce.com/docs/atlas.en-us.apexref.meta/apexref/apex_methods_system_datetime.htm#apex_System_Datetime_getTime)** Returns the number of milliseconds since January 1, 1970, 00:00:00 GMT represented by this DateTime object. - **[hour()](https://developer.salesforce.com/docs/atlas.en-us.apexref.meta/apexref/apex_methods_system_datetime.htm#apex_System_Datetime_hour)** Returns the hour component of a Datetime in the local time zone of the context user. - **[hourGmt()](https://developer.salesforce.com/docs/atlas.en-us.apexref.meta/apexref/apex_methods_system_datetime.htm#apex_System_Datetime_hourGmt)** Returns the hour component of a Datetime in the GMT time zone. - **[isSameDay(dateToCompare)](https://developer.salesforce.com/docs/atlas.en-us.apexref.meta/apexref/apex_methods_system_datetime.htm#apex_System_Datetime_isSameDay)** Returns true if the Datetime that called the method is the same as the specified Datetime in the local time zone of the context user. - **[millisecond()](https://developer.salesforce.com/docs/atlas.en-us.apexref.meta/apexref/apex_methods_system_datetime.htm#apex_System_Datetime_millisecond)** Return the millisecond component of a Datetime in the local time zone of the context user. - **[millisecondGmt()](https://developer.salesforce.com/docs/atlas.en-us.apexref.meta/apexref/apex_methods_system_datetime.htm#apex_System_Datetime_millisecondGmt)** Return the millisecond component of a Datetime in the GMT time zone. - **[minute()](https://developer.salesforce.com/docs/atlas.en-us.apexref.meta/apexref/apex_methods_system_datetime.htm#apex_System_Datetime_minute)** Returns the minute component of a Datetime in the local time zone of the context user. - **[minuteGmt()](https://developer.salesforce.com/docs/atlas.en-us.apexref.meta/apexref/apex_methods_system_datetime.htm#apex_System_Datetime_minuteGmt)** Returns the minute component of a Datetime in the GMT time zone. - **[month()](https://developer.salesforce.com/docs/atlas.en-us.apexref.meta/apexref/apex_methods_system_datetime.htm#apex_System_Datetime_month)** Returns the month component of a Datetime in the local time zone of the context user (1=Jan). - **[monthGmt()](https://developer.salesforce.com/docs/atlas.en-us.apexref.meta/apexref/apex_methods_system_datetime.htm#apex_System_Datetime_monthGmt)** Returns the month component of a Datetime in the GMT time zone (1=Jan). - **[newInstance(milliseconds)](https://developer.salesforce.com/docs/atlas.en-us.apexref.meta/apexref/apex_methods_system_datetime.htm#apex_System_Datetime_newInstance)** Constructs a Datetime and initializes it to represent the specified number of milliseconds since January 1, 1970, 00:00:00 GMT. - **[newInstance(date, time)](https://developer.salesforce.com/docs/atlas.en-us.apexref.meta/apexref/apex_methods_system_datetime.htm#apex_System_Datetime_newInstance_2)** Constructs a DateTime from the specified date and time in the local time zone. - **[newInstance(year, month, day)](https://developer.salesforce.com/docs/atlas.en-us.apexref.meta/apexref/apex_methods_system_datetime.htm#apex_System_Datetime_newInstance_3)** Constructs a Datetime from Integer representations of the specified year, month (1=Jan), and day at midnight in the local time zone. - **[newInstance(year, month, day, hour, minute, second)](https://developer.salesforce.com/docs/atlas.en-us.apexref.meta/apexref/apex_methods_system_datetime.htm#apex_System_Datetime_newInstance_4)** Constructs a Datetime from Integer representations of the specified year, month (1=Jan), day, hour, minute, and second in the local time zone. - **[newInstanceGmt(date, time)](https://developer.salesforce.com/docs/atlas.en-us.apexref.meta/apexref/apex_methods_system_datetime.htm#apex_System_Datetime_newInstanceGmt)** Constructs a DateTime from the specified date and time in the GMT time zone. - **[newInstanceGmt(year, month, date)](https://developer.salesforce.com/docs/atlas.en-us.apexref.meta/apexref/apex_methods_system_datetime.htm#apex_System_Datetime_newInstanceGmt_2)** Constructs a Datetime from Integer representations of the specified year, month (1=Jan), and day at midnight in the GMT time zone - **[newInstanceGmt(year, month, date, hour, minute, second)](https://developer.salesforce.com/docs/atlas.en-us.apexref.meta/apexref/apex_methods_system_datetime.htm#apex_System_Datetime_newInstanceGmt_3)** Constructs a Datetime from Integer representations of the specified year, month (1=Jan), day, hour, minute, and second in the GMT time zone - **[now()](https://developer.salesforce.com/docs/atlas.en-us.apexref.meta/apexref/apex_methods_system_datetime.htm#apex_System_Datetime_now)** Returns the current Datetime based on a GMT calendar. - **[parse(datetimeString)](https://developer.salesforce.com/docs/atlas.en-us.apexref.meta/apexref/apex_methods_system_datetime.htm#apex_System_Datetime_parse)** Constructs a Datetime from the given String in the local time zone and in the format of the user locale. - **[second()](https://developer.salesforce.com/docs/atlas.en-us.apexref.meta/apexref/apex_methods_system_datetime.htm#apex_System_Datetime_second)** Returns the second component of a Datetime in the local time zone of the context user. - **[secondGmt()](https://developer.salesforce.com/docs/atlas.en-us.apexref.meta/apexref/apex_methods_system_datetime.htm#apex_System_Datetime_secondGmt)** Returns the second component of a Datetime in the GMT time zone. - **[time()](https://developer.salesforce.com/docs/atlas.en-us.apexref.meta/apexref/apex_methods_system_datetime.htm#apex_System_Datetime_time)** Returns the time component of a Datetime in the local time zone of the context user. - **[timeGmt()](https://developer.salesforce.com/docs/atlas.en-us.apexref.meta/apexref/apex_methods_system_datetime.htm#apex_System_Datetime_timeGmt)** Returns the time component of a Datetime in the GMT time zone. - **[valueOf(dateTimeString)](https://developer.salesforce.com/docs/atlas.en-us.apexref.meta/apexref/apex_methods_system_datetime.htm#apex_System_Datetime_valueOf)** Returns a Datetime that contains the value of the specified string. - **[valueOf(fieldValue)](https://developer.salesforce.com/docs/atlas.en-us.apexref.meta/apexref/apex_methods_system_datetime.htm#apex_System_Datetime_valueOf_2)** Converts the specified object to a Datetime. Use this method to convert a history tracking field value or an object that represents a Datetime value. - **[valueOfGmt(dateTimeString)](https://developer.salesforce.com/docs/atlas.en-us.apexref.meta/apexref/apex_methods_system_datetime.htm#apex_System_Datetime_valueOfGmt)** Returns a Datetime that contains the value of the specified String. - **[year()](https://developer.salesforce.com/docs/atlas.en-us.apexref.meta/apexref/apex_methods_system_datetime.htm#apex_System_Datetime_year)** Returns the year component of a Datetime in the local time zone of the context user. - **[yearGmt()](https://developer.salesforce.com/docs/atlas.en-us.apexref.meta/apexref/apex_methods_system_datetime.htm#apex_System_Datetime_yearGmt)** Returns the year component of a Datetime in the GMT time zone. ### addDays(additionalDays) Adds the specified number of days to a Datetime. #### Signature public Datetime addDays(Integer additionalDays) #### Parameters - **additionalDays**: Type: [Integer](https://developer.salesforce.com/docs/atlas.en-us.apexref.meta/apexref/apex_methods_system_integer.htm#apex_methods_system_integer "Contains methods for the Integer primitive data type.") #### Return Value Type: [Datetime](#apex_methods_system_datetime "Contains methods for the Datetime primitive data type.") #### Example Datetime myDateTime = Datetime.newInstance(1960, 2, 17); Datetime newDateTime = myDateTime.addDays(2); Datetime expected = Datetime.newInstance(1960, 2, 19); Assert.areEqual(expected, newDateTime); ### addHours(additionalHours) Adds the specified number of hours to a Datetime. #### Signature public Datetime addHours(Integer additionalHours) #### Parameters - **additionalHours**: Type: [Integer](https://developer.salesforce.com/docs/atlas.en-us.apexref.meta/apexref/apex_methods_system_integer.htm#apex_methods_system_integer "Contains methods for the Integer primitive data type.") #### Return Value Type: [Datetime](#apex_methods_system_datetime "Contains methods for the Datetime primitive data type.") #### Example DateTime myDateTime = DateTime.newInstance(1997, 1, 31, 7, 8, 16); DateTime newDateTime = myDateTime.addHours(3); DateTime expected = DateTime.newInstance(1997, 1, 31, 10, 8, 16); Assert.areEqual(expected, newDateTime); ### addMinutes(additionalMinutes) Adds the specified number of minutes to a Datetime. #### Signature public Datetime addMinutes(Integer additionalMinutes) #### Parameters - **additionalMinutes**: Type: [Integer](https://developer.salesforce.com/docs/atlas.en-us.apexref.meta/apexref/apex_methods_system_integer.htm#apex_methods_system_integer "Contains methods for the Integer primitive data type.") #### Return Value Type: [Datetime](#apex_methods_system_datetime "Contains methods for the Datetime primitive data type.") #### Example DateTime myDateTime = DateTime.newInstance(1999, 2, 11, 8, 6, 16); DateTime newDateTime = myDateTime.addMinutes(7); DateTime expected = DateTime.newInstance(1999, 2, 11, 8, 13, 16); Assert.areEqual(expected, newDateTime); ### addMonths(additionalMonths) Adds the specified number of months to a Datetime. #### Signature public Datetime addMonths(Integer additionalMonths) #### Parameters - **additionalMonths**: Type: [Integer](https://developer.salesforce.com/docs/atlas.en-us.apexref.meta/apexref/apex_methods_system_integer.htm#apex_methods_system_integer "Contains methods for the Integer primitive data type.") #### Return Value Type: [Datetime](#apex_methods_system_datetime "Contains methods for the Datetime primitive data type.") #### Example DateTime myDateTime = DateTime.newInstance(2000, 7, 7, 7, 8, 12); DateTime newDateTime = myDateTime.addMonths(1); DateTime expected = DateTime.newInstance(2000, 8, 7, 7, 8, 12); Assert.areEqual(expected, newDateTime); ### addSeconds(additionalSeconds) Adds the specified number of seconds to a Datetime. #### Signature public Datetime addSeconds(Integer additionalSeconds) #### Parameters - **additionalSeconds**: Type: [Integer](https://developer.salesforce.com/docs/atlas.en-us.apexref.meta/apexref/apex_methods_system_integer.htm#apex_methods_system_integer "Contains methods for the Integer primitive data type.") #### Return Value Type: [Datetime](#apex_methods_system_datetime "Contains methods for the Datetime primitive data type.") #### Example DateTime myDateTime = DateTime.newInstance(2001, 7, 19, 10, 7, 12); DateTime newDateTime = myDateTime.addSeconds(4); DateTime expected = DateTime.newInstance(2001, 7, 19, 10, 7, 16); Assert.areEqual(expected, newDateTime); ### addYears(additionalYears) Adds the specified number of years to a Datetime. #### Signature public Datetime addYears(Integer additionalYears) #### Parameters - **additionalYears**: Type: [Integer](https://developer.salesforce.com/docs/atlas.en-us.apexref.meta/apexref/apex_methods_system_integer.htm#apex_methods_system_integer "Contains methods for the Integer primitive data type.") #### Return Value Type: [Datetime](#apex_methods_system_datetime "Contains methods for the Datetime primitive data type.") #### Example DateTime myDateTime = DateTime.newInstance(2009, 12, 17, 13, 6, 6); DateTime newDateTime = myDateTime.addYears(1); DateTime expected = DateTime.newInstance(2010, 12, 17, 13, 6, 6); Assert.areEqual(expected, newDateTime); ### date() Returns the Date component of a Datetime in the local time zone of the context user. #### Signature public Date date() #### Return Value Type: [Date](https://developer.salesforce.com/docs/atlas.en-us.apexref.meta/apexref/apex_methods_system_date.htm#apex_methods_system_date "Contains methods for the Date primitive data type.") #### Example DateTime myDateTime = DateTime.newInstance(2006, 3, 16, 12, 6, 13); Date myDate = myDateTime.date(); Date expected = Date.newInstance(2006, 3, 16); Assert.areEqual(expected, myDate); ### dateGMT() Return the Date component of a Datetime in the GMT time zone. #### Signature public Date dateGMT() #### Return Value Type: [Date](https://developer.salesforce.com/docs/atlas.en-us.apexref.meta/apexref/apex_methods_system_date.htm#apex_methods_system_date "Contains methods for the Date primitive data type.") #### Example // California local time, PST DateTime myDateTime = DateTime.newInstance(2006, 3, 16, 23, 0, 0); Date myDate = myDateTime.dateGMT(); Date expected = Date.newInstance(2006, 3, 17); Assert.areEqual(expected, myDate); ### day() Returns the day-of-month component of a Datetime in the local time zone of the context user. #### Signature public Integer day() #### Return Value Type: [Integer](https://developer.salesforce.com/docs/atlas.en-us.apexref.meta/apexref/apex_methods_system_integer.htm#apex_methods_system_integer "Contains methods for the Integer primitive data type.") #### Example DateTime myDateTime = DateTime.newInstance(1986, 2, 21, 23, 0, 0); Assert.areEqual(21, myDateTime.day()); ### dayGmt() Returns the day-of-month component of a Datetime in the GMT time zone. #### Signature public Integer dayGmt() #### Return Value Type: [Integer](https://developer.salesforce.com/docs/atlas.en-us.apexref.meta/apexref/apex_methods_system_integer.htm#apex_methods_system_integer "Contains methods for the Integer primitive data type.") #### Example // California local time, PST DateTime myDateTime = DateTime.newInstance(1987, 1, 14, 23, 0, 3); Assert.areEqual(15, myDateTime.dayGMT()); ### dayOfYear() Returns the day-of-year component of a Datetime in the local time zone of the context user. #### Signature public Integer dayOfYear() #### Return Value Type: [Integer](https://developer.salesforce.com/docs/atlas.en-us.apexref.meta/apexref/apex_methods_system_integer.htm#apex_methods_system_integer "Contains methods for the Integer primitive data type.") #### Example For example, February 5, 2008 08:30:12 would be day 36. Datetime myDate = Datetime.newInstance(2008, 2, 5, 8, 30, 12); Assert.areEqual(36, myDate.dayOfYear()); ### dayOfYearGmt() Returns the day-of-year component of a Datetime in the GMT time zone. #### Signature public Integer dayOfYearGmt() #### Return Value Type: [Integer](https://developer.salesforce.com/docs/atlas.en-us.apexref.meta/apexref/apex_methods_system_integer.htm#apex_methods_system_integer "Contains methods for the Integer primitive data type.") #### Example // This sample assumes we are in the PST timezone DateTime myDateTime = DateTime.newInstance(1999, 2, 5, 23, 0, 3); // January has 31 days + 5 days in February = 36 days // dayOfYearGmt() adjusts the time zone from the current time zone to GMT // by adding 8 hours to the PST time zone, so it's 37 days and not 36 days Assert.areEqual(37, myDateTime.dayOfYearGmt()); ### format() Converts the date to the local time zone and returns the converted date as a formatted string using the locale of the context user. If the time zone cannot be determined, GMT is used. #### Signature public String format() #### Return Value Type: [String](https://developer.salesforce.com/docs/atlas.en-us.apexref.meta/apexref/apex_methods_system_string.htm#apex_methods_system_string "Contains methods for the String primitive data type.") #### Example ![Note](https://developer.salesforce.com/docs/atlas.en-us.apexref.meta/apexref/images/icon_note.png) #### Note The sample is executed in an org where the “Enable ICU Locale Formats” crucial update is enabled. See [https://releasenotes.docs.salesforce.com/en-us/spring20/release-notes/rn\_forcecom\_globalization\_enable\_icu\_cruc.htm](https://releasenotes.docs.salesforce.com/en-us/spring20/release-notes/rn_forcecom_globalization_enable_icu_cruc.htm). DateTime.myDateTime = DateTime.newInstance(1993, 6, 6, 3, 3, 3); Assert.areEqual('6/6/1993, 3:03 AM', mydatetime.format()); ### format(dateFormatString) Converts the date to the local time zone and returns the converted date as a string using the supplied Java simple date format. If the time zone cannot be determined, GMT is used. #### Signature public String format(String dateFormatString) #### Parameters - **dateFormatString**: Type: [String](https://developer.salesforce.com/docs/atlas.en-us.apexref.meta/apexref/apex_methods_system_string.htm#apex_methods_system_string "Contains methods for the String primitive data type.") #### Return Value Type: [String](https://developer.salesforce.com/docs/atlas.en-us.apexref.meta/apexref/apex_methods_system_string.htm#apex_methods_system_string "Contains methods for the String primitive data type.") #### Usage For more information on the Java simple date format, see [Java SimpleDateFormat](http://docs.oracle.com/javase/7/docs/api/java/text/SimpleDateFormat.html "html (New Window)"). #### Example Datetime myDT = DateTime.newInstance(2022, 5, 4, 19, 37, 55); String myDate = myDT.format('yyyy-MM-dd h:mm a'); String expected = '2022-05-04 7:37 PM'; Assert.areEqual(expected, myDate); ### format(dateFormatString, timezone) Converts the date to the specified time zone and returns the converted date as a string using the supplied Java simple date format. If the supplied time zone is not in the correct format, GMT is used. #### Signature public String format(String dateFormatString, String timezone) #### Parameters - **dateFormatString**: Type: [String](https://developer.salesforce.com/docs/atlas.en-us.apexref.meta/apexref/apex_methods_system_string.htm#apex_methods_system_string "Contains methods for the String primitive data type.") - **timezone**: Type: [String](https://developer.salesforce.com/docs/atlas.en-us.apexref.meta/apexref/apex_methods_system_string.htm#apex_methods_system_string "Contains methods for the String primitive data type.") Valid time zone values for the timezone argument are the time zones of the Java TimeZone class that correspond to the time zones returned by the [TimeZone.getAvailableIDs](http://docs.oracle.com/javase/6/docs/api/java/util/TimeZone.html#getAvailableIDs\(\) "HTML (New Window)") method in Java. We recommend you use full time zone names, not the three-letter abbreviations. #### Return Value Type: [String](https://developer.salesforce.com/docs/atlas.en-us.apexref.meta/apexref/apex_methods_system_string.htm#apex_methods_system_string "Contains methods for the String primitive data type.") #### Usage For more information on the Java simple date format, see [Java SimpleDateFormat](http://docs.oracle.com/javase/7/docs/api/java/text/SimpleDateFormat.html "html (New Window)"). #### Example This example uses format to convert a GMT date to the America/New\_York time zone and formats the date using the specified date format. 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. Assert.areEqual( '06/01/2011 08:01:05', strConvertedDate); ### formatGmt(dateFormatString) Returns a Datetime as a string using the supplied Java simple date format and the GMT time zone. #### Signature public String formatGmt(String dateFormatString) #### Parameters - **dateFormatString**: Type: [String](https://developer.salesforce.com/docs/atlas.en-us.apexref.meta/apexref/apex_methods_system_string.htm#apex_methods_system_string "Contains methods for the String primitive data type.") #### Return Value Type: [String](https://developer.salesforce.com/docs/atlas.en-us.apexref.meta/apexref/apex_methods_system_string.htm#apex_methods_system_string "Contains methods for the String primitive data type.") #### Usage For more information on the Java simple date format, see [Java SimpleDateFormat](http://docs.oracle.com/javase/7/docs/api/java/text/SimpleDateFormat.html "html (New Window)"). #### Example DateTime myDateTime = DateTime.newInstance(1993, 6, 6, 3, 3, 3); String formatted = myDateTime.formatGMT('EEE, MMM d yyyy HH:mm:ss'); String expected = 'Sun, Jun 6 1993 10:03:03'; Assert.areEqual(expected, formatted); ### formatLong() Converts the date to the local time zone and returns the converted date in long date format. #### Signature public String formatLong() #### Return Value Type: [String](https://developer.salesforce.com/docs/atlas.en-us.apexref.meta/apexref/apex_methods_system_string.htm#apex_methods_system_string "Contains methods for the String primitive data type.") #### Example // 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() Returns the number of milliseconds since January 1, 1970, 00:00:00 GMT represented by this DateTime object. #### Signature public Long getTime() #### Return Value Type: [Long](https://developer.salesforce.com/docs/atlas.en-us.apexref.meta/apexref/apex_methods_system_long.htm#apex_methods_system_long "Contains methods for the Long primitive data type.") #### Example DateTime dt = DateTime.newInstanceGMT(2007, 6, 23, 3, 3, 3); Long gettime = dt.getTime(); Long expected = 1182567783000L; Assert.areEqual(expected, gettime); ### hour() Returns the hour component of a Datetime in the local time zone of the context user. #### Signature public Integer hour() #### Return Value Type: [Integer](https://developer.salesforce.com/docs/atlas.en-us.apexref.meta/apexref/apex_methods_system_integer.htm#apex_methods_system_integer "Contains methods for the Integer primitive data type.") #### Example DateTime myDateTime = DateTime.newInstance(1998, 11, 21, 3, 3, 3); Assert.areEqual(3 , myDateTime.hour()); ### hourGmt() Returns the hour component of a Datetime in the GMT time zone. #### Signature public Integer hourGmt() #### Return Value Type: [Integer](https://developer.salesforce.com/docs/atlas.en-us.apexref.meta/apexref/apex_methods_system_integer.htm#apex_methods_system_integer "Contains methods for the Integer primitive data type.") #### Example // California local time DateTime myDateTime = DateTime.newInstance(2000, 4, 27, 3, 3, 3); Assert.areEqual(10 , myDateTime.hourGMT()); ### isSameDay(dateToCompare) Returns true if the Datetime that called the method is the same as the specified Datetime in the local time zone of the context user. #### Signature public Boolean isSameDay(Datetime dateToCompare) #### Parameters - **dateToCompare**: Type: [Datetime](#apex_methods_system_datetime "Contains methods for the Datetime primitive data type.") #### Return Value Type: [Boolean](https://developer.salesforce.com/docs/atlas.en-us.apexref.meta/apexref/apex_methods_system_boolean.htm#apex_methods_system_boolean "Contains methods for the Boolean primitive data type.") #### Example datetime myDate = datetime.now(); datetime dueDate = datetime.newInstance(2008, 1, 30); boolean dueNow = myDate.isSameDay(dueDate); ### millisecond() Return the millisecond component of a Datetime in the local time zone of the context user. #### Signature public Integer millisecond() #### Return Value Type: [Integer](https://developer.salesforce.com/docs/atlas.en-us.apexref.meta/apexref/apex_methods_system_integer.htm#apex_methods_system_integer "Contains methods for the Integer primitive data type.") #### Example DateTime myDateTime = DateTime.now(); system.debug(myDateTime.millisecond()); ### millisecondGmt() Return the millisecond component of a Datetime in the GMT time zone. #### Signature public Integer millisecondGmt() #### Return Value Type: [Integer](https://developer.salesforce.com/docs/atlas.en-us.apexref.meta/apexref/apex_methods_system_integer.htm#apex_methods_system_integer "Contains methods for the Integer primitive data type.") #### Example DateTime myDateTime = DateTime.now(); system.debug(myDateTime.millisecondGMT()); ### minute() Returns the minute component of a Datetime in the local time zone of the context user. #### Signature public Integer minute() #### Return Value Type: [Integer](https://developer.salesforce.com/docs/atlas.en-us.apexref.meta/apexref/apex_methods_system_integer.htm#apex_methods_system_integer "Contains methods for the Integer primitive data type.") #### Example DateTime myDateTime = DateTime.newInstance(2001, 2, 27, 3, 3, 3); Assert.areEqual(3, myDateTime.minute()); ### minuteGmt() Returns the minute component of a Datetime in the GMT time zone. #### Signature public Integer minuteGmt() #### Return Value Type: [Integer](https://developer.salesforce.com/docs/atlas.en-us.apexref.meta/apexref/apex_methods_system_integer.htm#apex_methods_system_integer "Contains methods for the Integer primitive data type.") #### Example DateTime myDateTime = DateTime.newInstance(2002, 12, 3, 3, 3, 3); Assert.areEqual(3, myDateTime.minuteGMT()); ### month() Returns the month component of a Datetime in the local time zone of the context user (1=Jan). #### Signature public Integer month() #### Return Value Type: [Integer](https://developer.salesforce.com/docs/atlas.en-us.apexref.meta/apexref/apex_methods_system_integer.htm#apex_methods_system_integer "Contains methods for the Integer primitive data type.") #### Example DateTime myDateTime = DateTime.newInstance(2004, 11, 4, 3, 3, 3); Assert.areEqual(11, myDateTime.month()); ### monthGmt() Returns the month component of a Datetime in the GMT time zone (1=Jan). #### Signature public Integer monthGmt() #### Return Value Type: [Integer](https://developer.salesforce.com/docs/atlas.en-us.apexref.meta/apexref/apex_methods_system_integer.htm#apex_methods_system_integer "Contains methods for the Integer primitive data type.") #### Example DateTime myDateTime = DateTime.newInstance(2006, 11, 19, 3, 3, 3); Assert.areEqual(11, myDateTime.monthGMT()); ### newInstance(milliseconds) Constructs a Datetime and initializes it to represent the specified number of milliseconds since January 1, 1970, 00:00:00 GMT. #### Signature public static Datetime newInstance(Long milliseconds) #### Parameters - **milliseconds**: Type: [Long](https://developer.salesforce.com/docs/atlas.en-us.apexref.meta/apexref/apex_methods_system_long.htm#apex_methods_system_long "Contains methods for the Long primitive data type.") #### Return Value Type: [Datetime](#apex_methods_system_datetime "Contains methods for the Datetime primitive data type.") The returned date is in the GMT time zone. #### Example Long longtime = 1341828183000L; DateTime dt = DateTime.newInstance(longtime); DateTime expected = DateTime.newInstance(2012, 7, 09, 3, 3, 3); Assert.areEqual(expected, dt); ### newInstance(date, time) Constructs a DateTime from the specified date and time in the local time zone. #### Signature public static Datetime newInstance(Date date, Time time) #### Parameters - **date**: Type: [Date](https://developer.salesforce.com/docs/atlas.en-us.apexref.meta/apexref/apex_methods_system_date.htm#apex_methods_system_date "Contains methods for the Date primitive data type.") - **time**: Type: [Time](https://developer.salesforce.com/docs/atlas.en-us.apexref.meta/apexref/apex_methods_system_time.htm#apex_methods_system_time "Contains methods for the Time primitive data type.") #### Return Value Type: [Datetime](#apex_methods_system_datetime "Contains methods for the Datetime primitive data type.") The returned date is in the GMT time zone. #### Example Date myDate = Date.newInstance(2011, 11, 18); Time myTime = Time.newInstance(3, 3, 3, 0); DateTime dt = DateTime.newInstance(myDate, myTime); DateTime expected = DateTime.newInstance(2011, 11, 18, 3, 3, 3); Assert.areEqual(expected, dt); ### newInstance(year, month, day) Constructs a Datetime from Integer representations of the specified year, month (1=Jan), and day at midnight in the local time zone. #### Signature public static Datetime newInstance(Integer year, Integer month, Integer day) #### Parameters - **year**: Type: [Integer](https://developer.salesforce.com/docs/atlas.en-us.apexref.meta/apexref/apex_methods_system_integer.htm#apex_methods_system_integer "Contains methods for the Integer primitive data type.") - **month**: Type: [Integer](https://developer.salesforce.com/docs/atlas.en-us.apexref.meta/apexref/apex_methods_system_integer.htm#apex_methods_system_integer "Contains methods for the Integer primitive data type.") - **day**: Type: [Integer](https://developer.salesforce.com/docs/atlas.en-us.apexref.meta/apexref/apex_methods_system_integer.htm#apex_methods_system_integer "Contains methods for the Integer primitive data type.") #### Return Value Type: [Datetime](#apex_methods_system_datetime "Contains methods for the Datetime primitive data type.") The returned date is in the GMT time zone. #### Example datetime myDate = datetime.newInstance(2008, 12, 1); ### newInstance(year, month, day, hour, minute, second) Constructs a Datetime from Integer representations of the specified year, month (1=Jan), day, hour, minute, and second in the local time zone. #### Signature public static Datetime newInstance(Integer year, Integer month, Integer day, Integer hour, Integer minute, Integer second) #### Parameters - **year**: Type: [Integer](https://developer.salesforce.com/docs/atlas.en-us.apexref.meta/apexref/apex_methods_system_integer.htm#apex_methods_system_integer "Contains methods for the Integer primitive data type.") - **month**: Type: [Integer](https://developer.salesforce.com/docs/atlas.en-us.apexref.meta/apexref/apex_methods_system_integer.htm#apex_methods_system_integer "Contains methods for the Integer primitive data type.") - **day**: Type: [Integer](https://developer.salesforce.com/docs/atlas.en-us.apexref.meta/apexref/apex_methods_system_integer.htm#apex_methods_system_integer "Contains methods for the Integer primitive data type.") - **hour**: Type: [Integer](https://developer.salesforce.com/docs/atlas.en-us.apexref.meta/apexref/apex_methods_system_integer.htm#apex_methods_system_integer "Contains methods for the Integer primitive data type.") - **minute**: Type: [Integer](https://developer.salesforce.com/docs/atlas.en-us.apexref.meta/apexref/apex_methods_system_integer.htm#apex_methods_system_integer "Contains methods for the Integer primitive data type.") - **second**: Type: [Integer](https://developer.salesforce.com/docs/atlas.en-us.apexref.meta/apexref/apex_methods_system_integer.htm#apex_methods_system_integer "Contains methods for the Integer primitive data type.") #### Return Value Type: [Datetime](#apex_methods_system_datetime "Contains methods for the Datetime primitive data type.") The returned date is in the GMT time zone. #### Example Datetime myDate = Datetime.newInstance(2008, 12, 1, 12, 30, 2); ### newInstanceGmt(date, time) Constructs a DateTime from the specified date and time in the GMT time zone. #### Signature public static Datetime newInstanceGmt(Date date, Time time) #### Parameters - **date**: Type: [Date](https://developer.salesforce.com/docs/atlas.en-us.apexref.meta/apexref/apex_methods_system_date.htm#apex_methods_system_date "Contains methods for the Date primitive data type.") - **time**: Type: [Time](https://developer.salesforce.com/docs/atlas.en-us.apexref.meta/apexref/apex_methods_system_time.htm#apex_methods_system_time "Contains methods for the Time primitive data type.") #### Return Value Type: [Datetime](#apex_methods_system_datetime "Contains methods for the Datetime primitive data type.") #### Example Date myDate = Date.newInstance(2013, 11, 12); Time myTime = Time.newInstance(3, 3, 3, 0); DateTime dt = DateTime.newInstanceGMT(myDate, myTime); DateTime expected = DateTime.newInstanceGMT(2013, 11, 12, 3, 3, 3); Assert.areEqual(expected, dt); ### newInstanceGmt(year, month, date) Constructs a Datetime from Integer representations of the specified year, month (1=Jan), and day at midnight in the GMT time zone #### Signature public static Datetime newInstanceGmt(Integer year, Integer month, Integer date) #### Parameters - **year**: Type: [Integer](https://developer.salesforce.com/docs/atlas.en-us.apexref.meta/apexref/apex_methods_system_integer.htm#apex_methods_system_integer "Contains methods for the Integer primitive data type.") - **month**: Type: [Integer](https://developer.salesforce.com/docs/atlas.en-us.apexref.meta/apexref/apex_methods_system_integer.htm#apex_methods_system_integer "Contains methods for the Integer primitive data type.") - **date**: Type: [Integer](https://developer.salesforce.com/docs/atlas.en-us.apexref.meta/apexref/apex_methods_system_integer.htm#apex_methods_system_integer "Contains methods for the Integer primitive data type.") #### Return Value Type: [Datetime](#apex_methods_system_datetime "Contains methods for the Datetime primitive data type.") #### Example DateTime dt = DateTime.newInstanceGMT(1996, 3, 22); ### newInstanceGmt(year, month, date, hour, minute, second) Constructs a Datetime from Integer representations of the specified year, month (1=Jan), day, hour, minute, and second in the GMT time zone #### Signature public static Datetime newInstanceGmt(Integer year, Integer month, Integer date, Integer hour, Integer minute, Integer second) #### Parameters - **year**: Type: [Integer](https://developer.salesforce.com/docs/atlas.en-us.apexref.meta/apexref/apex_methods_system_integer.htm#apex_methods_system_integer "Contains methods for the Integer primitive data type.") - **month**: Type: [Integer](https://developer.salesforce.com/docs/atlas.en-us.apexref.meta/apexref/apex_methods_system_integer.htm#apex_methods_system_integer "Contains methods for the Integer primitive data type.") - **date**: Type: [Integer](https://developer.salesforce.com/docs/atlas.en-us.apexref.meta/apexref/apex_methods_system_integer.htm#apex_methods_system_integer "Contains methods for the Integer primitive data type.") - **hour**: Type: [Integer](https://developer.salesforce.com/docs/atlas.en-us.apexref.meta/apexref/apex_methods_system_integer.htm#apex_methods_system_integer "Contains methods for the Integer primitive data type.") - **minute**: Type: [Integer](https://developer.salesforce.com/docs/atlas.en-us.apexref.meta/apexref/apex_methods_system_integer.htm#apex_methods_system_integer "Contains methods for the Integer primitive data type.") - **second**: Type: [Integer](https://developer.salesforce.com/docs/atlas.en-us.apexref.meta/apexref/apex_methods_system_integer.htm#apex_methods_system_integer "Contains methods for the Integer primitive data type.") #### Return Value Type: [Datetime](#apex_methods_system_datetime "Contains methods for the Datetime primitive data type.") #### Example //California local time DateTime dt = DateTime.newInstanceGMT(1998, 1, 29, 2, 2, 3); DateTime expected = DateTime.newInstance(1998, 1, 28, 18, 2, 3); Assert.areEqual(expected, dt); ### now() Returns the current Datetime based on a GMT calendar. #### Signature public static Datetime now() #### Return Value Type: [Datetime](#apex_methods_system_datetime "Contains methods for the Datetime primitive data type.") The format of the returned datetime is: 'MM/DD/YYYY HH:MM PERIOD' #### Example datetime myDateTime = datetime.now(); ### parse(datetimeString) Constructs a Datetime from the given String in the local time zone and in the format of the user locale. #### Signature public static Datetime parse(String datetimeString) #### Parameters - **datetimeString**: Type: [String](https://developer.salesforce.com/docs/atlas.en-us.apexref.meta/apexref/apex_methods_system_string.htm#apex_methods_system_string "Contains methods for the String primitive data type.") #### Return Value Type: [Datetime](#apex_methods_system_datetime "Contains methods for the Datetime primitive data type.") The returned date is in the GMT time zone. #### Example This example uses parse to create a Datetime from a date passed in as a string and that is formatted for the English (United States) locale. You may need to change the format of the date string if you have a different locale. ![Note](https://developer.salesforce.com/docs/atlas.en-us.apexref.meta/apexref/images/icon_note.png) #### Note This sample is executed in an org where the “Enable ICU Locale Formats” crucial update is enabled. See [Enable ICU Locale Formats (Release Update)](https://help.salesforce.com/s/articleView?id=release-notes.rn_forcecom_globalization_enable_icu_update.htm&release=234&type=5&language=en_US) . Datetime dt = DateTime.parse('10/14/2011, 11:46 AM'); String myDtString = dt.format(); Assert.areEqual('10/14/2011, 11:46 AM', myDtString); ### second() Returns the second component of a Datetime in the local time zone of the context user. #### Signature public Integer second() #### Return Value Type: [Integer](https://developer.salesforce.com/docs/atlas.en-us.apexref.meta/apexref/apex_methods_system_integer.htm#apex_methods_system_integer "Contains methods for the Integer primitive data type.") #### Example DateTime dt = DateTime.newInstanceGMT(1999, 9, 22, 3, 1, 2); Assert.areEqual(2, dt.second()); ### secondGmt() Returns the second component of a Datetime in the GMT time zone. #### Signature public Integer secondGmt() #### Return Value Type: [Integer](https://developer.salesforce.com/docs/atlas.en-us.apexref.meta/apexref/apex_methods_system_integer.htm#apex_methods_system_integer "Contains methods for the Integer primitive data type.") #### Example DateTime dt = DateTime.newInstance(2000, 2, 3, 3, 1, 5); Assert.areEqual(5, dt.secondGMT()); ### time() Returns the time component of a Datetime in the local time zone of the context user. #### Signature public Time time() #### Return Value Type: [Time](https://developer.salesforce.com/docs/atlas.en-us.apexref.meta/apexref/apex_methods_system_time.htm#apex_methods_system_time "Contains methods for the Time primitive data type.") #### Example DateTime dt = DateTime.newInstance(2002, 11, 21, 0, 2, 2); Time expected = Time.newInstance(0, 2, 2, 0); Assert.areEqual(expected, dt.time()); ### timeGmt() Returns the time component of a Datetime in the GMT time zone. #### Signature public Time timeGmt() #### Return Value Type: [Time](https://developer.salesforce.com/docs/atlas.en-us.apexref.meta/apexref/apex_methods_system_time.htm#apex_methods_system_time "Contains methods for the Time primitive data type.") #### Example // This sample is based on the PST time zone DateTime dt = DateTime.newInstance(2004, 1, 27, 4, 1, 2); Time expected = Time.newInstance(12, 1, 2, 0); // 8 hours are added to the time to convert it from // PST to GMT Assert.areEqual(expected, dt.timeGMT()); ### valueOf(dateTimeString) Returns a Datetime that contains the value of the specified string. #### Signature public static Datetime valueOf(String dateTimeString) #### Parameters - **dateTimeString**: Type: [String](https://developer.salesforce.com/docs/atlas.en-us.apexref.meta/apexref/apex_methods_system_string.htm#apex_methods_system_string "Contains methods for the String primitive data type.") #### Return Value Type: [Datetime](#apex_methods_system_datetime "Contains methods for the Datetime primitive data type.") The returned date is in the GMT time zone. #### Usage The specified string should use the standard date format “yyyy-MM-dd HH:mm:ss” in the local time zone. #### Example 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(fieldValue) Converts the specified object to a Datetime. Use this method to convert a history tracking field value or an object that represents a Datetime value. #### Signature public static Datetime valueOf(Object fieldValue) #### Parameters - **fieldValue**: Type: Object #### Return Value Type: [Datetime](#apex_methods_system_datetime "Contains methods for the Datetime primitive data type.") #### Usage Use this method with the OldValue or NewValue fields of history sObjects, such as AccountHistory, when the field is a Date/Time field. #### Example List ahlist = \[SELECT Field,OldValue,NewValue FROM AccountHistory WITH USER\_MODE\]; 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(dateTimeString) Returns a Datetime that contains the value of the specified String. #### Signature public static Datetime valueOfGmt(String dateTimeString) #### Parameters - **dateTimeString**: Type: [String](https://developer.salesforce.com/docs/atlas.en-us.apexref.meta/apexref/apex_methods_system_string.htm#apex_methods_system_string "Contains methods for the String primitive data type.") #### Return Value Type: [Datetime](#apex_methods_system_datetime "Contains methods for the Datetime primitive data type.") #### Usage The specified string should use the standard date format “yyyy-MM-dd HH:mm:ss” in the GMT time zone. #### Example // California locale time string year = '2009'; string month = '3'; string day = '5'; string hour = '5'; string minute = '2'; string second = '2'; string stringDate = year + '-' + month + '-' + day + ' ' + hour + ':' + minute + ':' + second; Datetime myDate = Datetime.valueOfGMT(stringDate); DateTime expected = DateTime.newInstance(2009, 3, 4, 21, 2, 2); Assert.areEqual(expected, myDate); ### year() Returns the year component of a Datetime in the local time zone of the context user. #### Signature public Integer year() #### Return Value Type: [Integer](https://developer.salesforce.com/docs/atlas.en-us.apexref.meta/apexref/apex_methods_system_integer.htm#apex_methods_system_integer "Contains methods for the Integer primitive data type.") #### Example DateTime dt = DateTime.newInstance(2012, 1, 26, 5, 2, 4); Assert.areEqual(2012, dt.year()); ### yearGmt() Returns the year component of a Datetime in the GMT time zone. #### Signature public Integer yearGmt() #### Return Value Type: [Integer](https://developer.salesforce.com/docs/atlas.en-us.apexref.meta/apexref/apex_methods_system_integer.htm#apex_methods_system_integer "Contains methods for the Integer primitive data type.") #### Example DateTime dt = DateTime.newInstance(2012, 10, 4, 6, 4, 6); Assert.areEqual(2012, dt.yearGMT());