You can create a new DateTime value in any of the following ways:

• By calling any of the overloads of the DateTime constructor that allow you to specify specific elements of the date and time value (such as the year, month, and day, or the number of ticks). The following statement illustrates a call to one of the DateTime constructors to create a date with a specific year, month, day, hour, minute, and second.

  Visual Basic

  Dim date1 As New Date(2008, 5, 1, 8, 30, 52)
  

  C#

  DateTime date1 = new DateTime(2008, 5, 1, 8, 30, 52);
  

• By using any compiler-specific syntax for declaring date and time values. For example, the following Visual Basic statement initializes a new DateTime value.

  Visual Basic

  Dim date1 As Date = #5/1/2008 8:30:52AM#
  

• By assigning the DateTime object a date and time value returned by a property or method. The following example assigns the current date and time, the current Coordinated Universal Time (UTC) date and time, and the current date to three new DateTime variables.

  Visual Basic

  Dim date1 As Date = Date.Now
  Dim date2 As Date = Date.UtcNow
  Dim date3 As Date = Date.Today
  

  C#

  DateTime date1 = DateTime.Now;
  DateTime date2 = DateTime.UtcNow;
  DateTime date3 = DateTime.Today;
  

• By parsing the string representation of a date and time value. The Parse, ParseExact, TryParse, and TryParseExact methods all convert a string to its equivalent date and time value. The following example uses the Parse method to parse a string and convert it to a DateTime value.

  Visual Basic

  Dim dateString As String = "5/1/2008 8:30:52 AM"
  Dim date1 As Date = Date.Parse(dateString, _
                           System.Globalization.CultureInfo.InvariantCulture) 
  

  C#

  string dateString = "5/1/2008 8:30:52 AM";
  DateTime date1 = DateTime.Parse(dateString, 
                            System.Globalization.CultureInfo.InvariantCulture); 
  

  Note that the TryParse and TryParseExact methods indicate whether a particular string contains a valid representation of a DateTime value in addition to performing the conversion.

• By calling the DateTime structure's implicit default constructor. (For details on the implicit default constructor of a value type, see Value Types (C# Reference).) An approximate equivalent, for compilers that support it, is declaring a DateTime value without explicitly assigning a date and time to it. The following example illustrates a call to the DateTime implicit default constructor in C# and Visual Basic, as well as a DateTime variable declaration with no assignment in Visual Basic.

  Visual Basic

  Dim dat1 As DateTime
  ' The following method call displays 1/1/0001 12:00:00 AM.
  Console.WriteLine(dat1.ToString(System.Globalization.CultureInfo.InvariantCulture))
  ' The following method call displays True.
  Console.WriteLine(dat1.Equals(Date.MinValue))
  
  Dim dat2 As New DateTime()
  ' The following method call displays 1/1/0001 12:00:00 AM.
  Console.WriteLine(dat2.ToString(System.Globalization.CultureInfo.InvariantCulture))
  ' The following method call displays True.
  Console.WriteLine(dat2.Equals(Date.MinValue))
  

  C#

  DateTime dat1 = new DateTime();
  // The following method call displays 1/1/0001 12:00:00 AM.
  Console.WriteLine(dat1.ToString(System.Globalization.CultureInfo.InvariantCulture));
  // The following method call displays True.
  Console.WriteLine(dat1.Equals(DateTime.MinValue));
  

Internally, all DateTime values are represented as the number of ticks (the number of 100-nanosecond intervals) that have elapsed since 12:00:00 midnight, January 1, 0001. The actual DateTime value is independent of the way in which that value appears when displayed in a user interface element or when written to a file. The appearance of a DateTime value is the result of a formatting operation. Formatting is the process of converting a value to its string representation.

Because the appearance of date and time values is dependent on such factors as culture, international standards, application requirements, and personal preference, the DateTime structure offers a great deal of flexibility in formatting date and time values through the overloads of its ToString method. The default DateTime..::.ToString()()() method returns the string representation of a date and time value using the current culture's short date and long time pattern. The following example uses the default DateTime..::.ToString()()() method to display the date and time using the short date and long time pattern for the en-US culture, the current culture on the computer on which the example was run.

Dim date1 As Date = #3/1/2008 7:00AM#
Console.WriteLine(date1.ToString())
' For en-US culture, displays 3/1/2008 7:00:00 AM

DateTime date1 = new DateTime(2008, 3, 1, 7, 0, 0);
Console.WriteLine(date1.ToString());
// For en-US culture, displays 3/1/2008 7:00:00 AM

The DateTime..::.ToString(IFormatProvider) method returns the string representation of a date and time value using the short date and long time pattern of a specific culture. The following example uses the DateTime..::.ToString(IFormatProvider) method to display the date and time using the short date and long time pattern for the fr-FR culture.

Dim date1 As Date = #3/1/2008 7:00AM#
Console.WriteLine(date1.ToString(System.Globalization.CultureInfo.CreateSpecificCulture("fr-FR")))
' Displays 01/03/2008 07:00:00

DateTime date1 = new DateTime(2008, 3, 1, 7, 0, 0);
Console.WriteLine(date1.ToString(System.Globalization.CultureInfo.CreateSpecificCulture("fr-FR")));
// Displays 01/03/2008 07:00:00

The DateTime..::.ToString(String) method returns the string representation of the date and time in a format defined by a standard or custom format specifier and using the formatting conventions of the current culture. The following example uses the DateTime..::.ToString(String) method to display the full date and time pattern for the en-US culture, the current culture on the computer on which the example was run.

Dim date1 As Date = #3/1/2008 7:00AM#
Console.WriteLine(date1.ToString("F"))
' Displays Saturday, March 01, 2008 7:00:00 AM

DateTime date1 = new DateTime(2008, 3, 1, 7, 0, 0);
Console.WriteLine(date1.ToString("F"));
// Displays Saturday, March 01, 2008 7:00:00 AM

The DateTime..::.ToString(String, IFormatProvider) method returns the string representation of the date and time in a format defined by a specific format specifier and using the formatting conventions of a specific culture. The following example uses the DateTime..::.ToString(String, IFormatProvider) method to display the full date and time pattern for the fr-FR culture.

Dim date1 As Date = #3/1/2008 7:00AM#
Console.WriteLine(date1.ToString("F", New System.Globalization.CultureInfo("fr-FR")))
' Displays samedi 1 mars 2008 07:00:00

DateTime date1 = new DateTime(2008, 3, 1, 7, 0, 0);
Console.WriteLine(date1.ToString("F", new System.Globalization.CultureInfo("fr-FR")));
// Displays samedi 1 mars 2008 07:00:00

Prior to the .NET Framework version 2.0, the DateTime structure contains a 64-bit field composed of an unused 2-bit field concatenated with a private Ticks field, which is a 62-bit unsigned field that contains the number of ticks that represent the date and time. The value of the Ticks field can be obtained with the Ticks property.

Starting with the .NET Framework 2.0, the DateTime structure contains a 64-bit field composed of a private Kind field concatenated with the Ticks field. The Kind field is a 2-bit field that indicates whether the DateTime structure represents a local time, a Coordinated Universal Time (UTC), or the time in an unspecified time zone. The Kind field is used when performing time conversions between time zones, but not for time comparisons or arithmetic. The value of the Kind field can be obtained with the Kind property.

Note

An alternative to the DateTime structure for working with date and time values in particular time zones is the DateTimeOffset structure. The DateTimeOffset structure stores date and time information in a private DateTime field and the number of minutes by which that date and time differs from UTC in a private Int16 field. This makes it possible for a DateTimeOffset value to reflect the time in a particular time zone, whereas a DateTime value can unambiguously reflect only UTC and the local time zone's time. For a discussion about when to use the DateTime structure or the DateTimeOffset structure when working with date and time values, see Choosing Between DateTime, DateTimeOffset, and TimeZoneInfo.

Descriptions of time values in the DateTime type are often expressed using the Coordinated Universal Time (UTC) standard, which is the internationally recognized name for Greenwich Mean Time (GMT). Coordinated Universal Time is the time as measured at zero degrees longitude, the UTC origin point. Daylight saving time is not applicable to UTC.

Local time is relative to a particular time zone. A time zone is associated with a time zone offset, which is the displacement of the time zone measured in hours from the UTC origin point. In addition, local time is optionally affected by daylight saving time, which adds or subtracts an hour from the length of a day. Consequently, local time is calculated by adding the time zone offset to UTC and adjusting for daylight saving time if necessary. The time zone offset at the UTC origin point is zero.

UTC time is suitable for calculations, comparisons, and storing dates and time in files. Local time is appropriate for display in user interfaces of desktop applications. Time zone-aware applications (such as many Web applications) also need to work with a number of other time zones.

If the Kind property of a DateTime object is DateTimeKind..::.Unspecified, it is unspecified whether the time represented is local time, UTC time, or a time in some other time zone.

A calculation using a DateTime structure, such as Add or Subtract, does not modify the value of the structure. Instead, the calculation returns a new DateTime structure whose value is the result of the calculation.

Conversion operations between time zones (such as between UTC and local time, or between one time zone and another) take daylight saving time into account, but arithmetic and comparison operations do not.

The DateTime structure itself offers limited support for converting from one time zone to another. You can use the ToLocalTime method to convert UTC to local time, or you can use the ToUniversalTime method to convert from local time to UTC. However, a full set of time zone conversion methods is available in the TimeZoneInfo class. Using these methods, you can convert the time in any one of the world's time zones to the time in any other time zone.

Calculations and comparisons of DateTime objects are meaningful only if the objects represent times in the same time zone. You can use a TimeZoneInfo object to represent a DateTime value's time zone, although the two are loosely coupled. (That is, a DateTime object does not have a property that returns an object that represents that date and time value's time zone other than the Kind property.) For this reason, in a time zone-aware application, you must rely on some external mechanism to determine the time zone in which a DateTime object was created. For example, you could use a structure that wraps both the DateTime value and the TimeZoneInfo object that represents the DateTime value's time zone. For details on using UTC in calculations and comparisons with DateTime values, see Performing Arithmetic Operations with Dates and Times.

Each DateTime member implicitly uses the Gregorian calendar to perform its operation, with the exception of constructors that specify a calendar, and methods with a parameter derived from IFormatProvider, such as System.Globalization..::.DateTimeFormatInfo, that implicitly specifies a calendar.

Operations by members of the DateTime type take into account details such as leap years and the number of days in a month.

The DateTime and TimeSpan value types differ in that a DateTime represents an instant in time whereas a TimeSpan represents a time interval. This means, for example, that you can subtract one instance of DateTime from another to obtain a TimeSpan object that represents the time interval between them. Or you could add a positive TimeSpan to the current DateTime to obtain a DateTime value that represents a future date.

You can add or subtract a time interval from a DateTime object. Time intervals can be negative or positive, can be expressed in units such as ticks or seconds, or can be expressed as a TimeSpan object.

A DateTime value that is transferred to a COM application, then is transferred back to a managed application, is said to round-trip. However, a DateTime value that specifies only a time does not round-trip as you might expect.

If you round-trip only a time, such as 3 P.M., the final date and time is December 30, 1899 C.E. at 3:00 P.M., instead of January, 1, 0001 C.E. at 3:00 P.M. This happens because the .NET Framework and COM assume a default date when only a time is specified. However, the COM system assumes a base date of December 30, 1899 C.E. while the .NET Framework assumes a base date of January, 1, 0001 C.E.

When only a time is passed from the .NET Framework to COM, special processing is performed that converts the time to the format used by COM. When only a time is passed from COM to the .NET Framework, no special processing is performed because that would corrupt legitimate dates and times on or before December 30, 1899. This also means if a date starts its round-trip from COM, the .NET Framework and COM preserve the date.

The behavior of the .NET Framework and COM means that if your application round-trips a DateTime that only specifies a time, your application must remember to modify or ignore the erroneous date from the final DateTime object.

Puede crear un nuevo valor DateTime de cualquiera de las maneras siguientes:

• Mediante una llamada a cualquiera de las sobrecargas del constructor DateTime que le permiten especificar elementos concretos del valor de fecha y hora (como el año, mes y día o el número de pasos). En la instrucción siguiente se muestra una llamada a uno de los constructores DateTime para crear una fecha con un año, mes, día, hora, minuto y segundo concretos.

  Visual Basic

  Dim date1 As New Date(2008, 5, 1, 8, 30, 52)
  

  C#

  DateTime date1 = new DateTime(2008, 5, 1, 8, 30, 52);
  

• Mediante cualquier sintaxis específica del compilador para declarar los valores de fecha y hora. Por ejemplo, la instrucción de Visual Basic siguiente inicializa un nuevo valor DateTime.

  Visual Basic

  Dim date1 As Date = #5/1/2008 8:30:52AM#
  

• Mediante la asignación al objeto DateTime de un valor de fecha y hora devuelto por una propiedad o método. En el ejemplo siguiente se asignan la fecha y hora actuales, la fecha y hora de la Hora universal coordinada (hora UTC) y la fecha actual a tres nuevas variables DateTime.

  Visual Basic

  Dim date1 As Date = Date.Now
  Dim date2 As Date = Date.UtcNow
  Dim date3 As Date = Date.Today
  

  C#

  DateTime date1 = DateTime.Now;
  DateTime date2 = DateTime.UtcNow;
  DateTime date3 = DateTime.Today;
  

• Con el análisis de la representación de cadena de un valor de fecha y hora. Los métodos Parse, ParseExact, TryParseExact y TryParse convierten una cadena en su valor de fecha y hora equivalente. En el ejemplo siguiente se utiliza el método Parse para analizar una cadena y convertirlo en un valor DateTime.

  Visual Basic

  Dim dateString As String = "5/1/2008 8:30:52 AM"
  Dim date1 As Date = Date.Parse(dateString, _
                           System.Globalization.CultureInfo.InvariantCulture) 
  

  C#

  string dateString = "5/1/2008 8:30:52 AM";
  DateTime date1 = DateTime.Parse(dateString, 
                            System.Globalization.CultureInfo.InvariantCulture); 
  

  Observe que los métodos TryParseExact y TryParse indican si una cadena determinada contiene una representación válida de un valor de DateTime a la vez que realiza la conversión.

• Mediante una llamada al constructor predeterminado implícito de la estructura DateTime. (Para obtener información detallada sobre el constructor predeterminado implícito de un tipo de valor, vea Tipos de valor (Referencia de C#).) Un equivalente aproximado, para los compiladores que lo admiten, es declarar un valor DateTime sin asignarle explícitamente una fecha y hora. En el ejemplo siguiente se muestra una llamada al constructor predeterminado implícito de DateTime en C# y Visual Basic, así como una declaración de variable DateTime sin asignación en Visual Basic.

  Visual Basic

  Dim dat1 As DateTime
  ' The following method call displays 1/1/0001 12:00:00 AM.
  Console.WriteLine(dat1.ToString(System.Globalization.CultureInfo.InvariantCulture))
  ' The following method call displays True.
  Console.WriteLine(dat1.Equals(Date.MinValue))
  
  Dim dat2 As New DateTime()
  ' The following method call displays 1/1/0001 12:00:00 AM.
  Console.WriteLine(dat2.ToString(System.Globalization.CultureInfo.InvariantCulture))
  ' The following method call displays True.
  Console.WriteLine(dat2.Equals(Date.MinValue))
  

  C#

  DateTime dat1 = new DateTime();
  // The following method call displays 1/1/0001 12:00:00 AM.
  Console.WriteLine(dat1.ToString(System.Globalization.CultureInfo.InvariantCulture));
  // The following method call displays True.
  Console.WriteLine(dat1.Equals(DateTime.MinValue));
  

Internamente, todos los valores DateTime se representan como el número de pasos (el número de intervalos de 100 nanosegundos) transcurridos desde la medianoche (00:00:00) del 1 de enero de 0001. El valor DateTime real es independiente de la manera en la que ese valor aparece cuando se mostró en un elemento de la interfaz de usuario o cuando se escribe en un archivo. La apariencia de un valor DateTime es el resultado de una operación de formato. Dar formato es el proceso de convertir un valor en su representación de cadena.

Como la apariencia de los valores de fecha y hora depende de factores como la referencia cultural, normas internacionales, requisitos de aplicación y preferencias personales, la estructura DateTime ofrece una gran flexibilidad para dar formato a los valores de fecha y hora a través de las sobrecargas de su método ToString. El método DateTime..::.ToString()()() predeterminado devuelve la representación de cadena de un valor de fecha y hora utilizando la fecha corta de la referencia cultural actual y el modelo horario largo. En el ejemplo siguiente se utiliza el método DateTime..::.ToString()()() predeterminado para mostrar la fecha y hora utilizando la fecha corta y el modelo horario largo para la referencia cultural en-US, que era la referencia cultural actual del equipo en el que se ejecutó el ejemplo.

Dim date1 As Date = #3/1/2008 7:00AM#
Console.WriteLine(date1.ToString())
' For en-US culture, displays 3/1/2008 7:00:00 AM

DateTime date1 = new DateTime(2008, 3, 1, 7, 0, 0);
Console.WriteLine(date1.ToString());
// For en-US culture, displays 3/1/2008 7:00:00 AM

El método DateTime..::.ToString(IFormatProvider) devuelve la representación de cadena de un valor de fecha y hora utilizando la fecha corta y el modelo horario largo de una referencia cultural concreta. En el ejemplo siguiente se utiliza el método DateTime..::.ToString(IFormatProvider) para mostrar la fecha y hora utilizando la fecha corta y el modelo horario largo para la referencia cultural fr-FR.

Dim date1 As Date = #3/1/2008 7:00AM#
Console.WriteLine(date1.ToString(System.Globalization.CultureInfo.CreateSpecificCulture("fr-FR")))
' Displays 01/03/2008 07:00:00

DateTime date1 = new DateTime(2008, 3, 1, 7, 0, 0);
Console.WriteLine(date1.ToString(System.Globalization.CultureInfo.CreateSpecificCulture("fr-FR")));
// Displays 01/03/2008 07:00:00

El método DateTime..::.ToString(String) devuelve la representación de cadena de la fecha y hora en un formato definido por un especificador de formato estándar o personalizado, utilizando las convenciones de formato de la referencia cultural actual. En el ejemplo siguiente se utiliza el método DateTime..::.ToString(String) para mostrar el modelo completo de fecha y hora para la referencia cultural en-US, que era la referencia cultural actual del equipo en el que se ejecutó el ejemplo.

Dim date1 As Date = #3/1/2008 7:00AM#
Console.WriteLine(date1.ToString("F"))
' Displays Saturday, March 01, 2008 7:00:00 AM

DateTime date1 = new DateTime(2008, 3, 1, 7, 0, 0);
Console.WriteLine(date1.ToString("F"));
// Displays Saturday, March 01, 2008 7:00:00 AM

El método DateTime..::.ToString(String, IFormatProvider) devuelve la representación de cadena de la fecha y hora en un formato definido por un especificador de formato concreto, utilizando las convenciones de formato de una referencia cultural concreta. En el ejemplo siguiente se utiliza el método DateTime..::.ToString(String, IFormatProvider) para mostrar el modelo completo de fecha y hora utilizando la fecha corta y el modelo horario largo para la referencia cultural fr-FR.

Dim date1 As Date = #3/1/2008 7:00AM#
Console.WriteLine(date1.ToString("F", New System.Globalization.CultureInfo("fr-FR")))
' Displays samedi 1 mars 2008 07:00:00

DateTime date1 = new DateTime(2008, 3, 1, 7, 0, 0);
Console.WriteLine(date1.ToString("F", new System.Globalization.CultureInfo("fr-FR")));
// Displays samedi 1 mars 2008 07:00:00

En las versiones anteriores a la versión 2.0 de .NET Framework, la estructura DateTime contiene un campo de 64 bits formado por un campo de 2 bits no utilizados concatenado a un campo privado Ticks, que es un campo sin firma de 62 bits que contiene el número de pasos que representan la fecha y la hora. El valor del campo Ticks se puede obtener con la propiedad Ticks.

A partir de la versión 2.0 de .NET Framework, la estructura DateTime contiene un campo de 64 bits formado por un campo Kind privado concatenado al campo Ticks. El campo Kind es un campo de 2 bits que indica si la estructura DateTime representa una hora local, una hora universal coordinada (UTC) o la hora en una zona horaria no especificada. Este campo se utiliza cuando se realizan conversiones de horas entre zonas horarias, pero no para realizar operaciones aritméticas o de comparación de horas. El valor del campo Kind se puede obtener con la propiedad Kind.

Nota

Una alternativa a la estructura DateTime para trabajar en particular con valores de fecha y hora en zonas horarias concretas es la estructura DateTimeOffset. La estructura DateTimeOffset almacena información de fecha y hora en un campo DateTime privado y el número de minutos en que esa fecha y hora difiere de la hora UTC en un campo Int16 privado. Esto permite que un valor de DateTimeOffset refleje la hora en una zona horaria determinada, mientras que un valor de DateTime puede reflejar inequívocamente sólo la hora UTC y la hora de la zona horaria local. Para obtener una explicación de cuándo se debe utilizar la estructura DateTime o la estructura DateTimeOffset al trabajar con valores de fecha y hora, vea Elegir entre DateTime, DateTimeOffset y TimeZoneInfo.

Las descripciones de los valores de hora del tipo DateTime se suelen expresar utilizando el estándar de hora universal coordinada (UTC), que es el nombre con el que se conoce internacionalmente a la hora media de Greenwich (GMT). La hora universal coordinada es la hora que se mide en la longitud cero grados, punto de origen de UTC. El horario de verano no se aplica a UTC.

La hora local está relacionada con una zona horaria determinada. Una zona horaria se asocia a un desplazamiento de zona horaria, que es la diferencia medida en horas entre la zona horaria y el punto de origen de UTC. Además, a la hora local le afecta opcionalmente el horario de verano, que agrega o resta una hora a la duración del día. Por consiguiente, la hora local se calcula agregando el desplazamiento de zona horaria a la hora UTC y haciendo los ajustes oportunos por el horario de verano, en caso necesario. El desplazamiento de zona horaria en el punto de origen de UTC es cero.

La hora UTC es adecuada para los cálculos, las comparaciones y el almacenamiento de fechas y horas en los archivos. La hora local es apropiada para la presentación en las interfaces de usuario de aplicaciones de escritorio. Las aplicaciones que tienen en cuenta la zona horaria (como muchas aplicaciones web) también necesitan trabajar con otras zonas horarias.

Si la propiedad Kind de un objeto DateTime es DateTimeKind..::.Unspecified, no se especifica si la hora representada es la hora local, la hora UTC o una hora de otra zona horaria.

Un cálculo utilizando una estructura DateTime, como Add o Subtract, no modifica el valor de la estructura. En su lugar, el cálculo devuelve una nueva estructura DateTime cuyo valor es el resultado del cálculo.

Las operaciones de conversión entre zonas horarias (como entre la hora UTC y la hora local, o entre una zona horaria y otra) tienen en cuenta el horario de verano, aunque las operaciones aritméticas y de comparación no lo hacen.

La propia estructura DateTime proporciona compatibilidad limitada para la conversión de una zona horaria a otra. Puede utilizar el método ToLocalTime para convertir de hora UTC a hora local, o el método ToUniversalTime para convertir de hora local a hora UTC. No obstante, existe un conjunto completo de métodos de conversión de zonas horarias en la clase TimeZoneInfo. Con estos métodos, puede convertir la hora de cualquiera de las zonas horarias del mundo en la hora de cualquier otra zona horaria.

Los cálculos y las comparaciones de objetos DateTime sólo tienen significado si los objetos representan horas de la misma zona horaria. Puede utilizar un objeto TimeZoneInfo para representar la zona horaria de un valor de DateTime, aunque tengan una correspondencia imprecisa. Es decir, un objeto DateTime no tiene una propiedad que devuelva un objeto que represente la zona horaria de ese valor de fecha y hora salvo la propiedad Kind. Por esta razón, en una aplicación que tenga en cuenta la zona horaria, debe basarse en algún mecanismo externo para determinar la zona horaria en que se creó un objeto DateTime. Por ejemplo, puede utilizar una estructura que incluya el valor de DateTime y el objeto TimeZoneInfo que representa la zona horaria del valor de DateTime. Para obtener información detallada sobre el uso de la hora UTC en cálculos y comparaciones con valores DateTime, vea Efectuar operaciones aritméticas con fechas y horas.

Cada miembro de DateTime usa de forma implícita el calendario gregoriano para realizar sus operaciones, excepto los constructores que especifican un calendario y los métodos con un parámetro derivado de IFormatProvider, como System.Globalization..::.DateTimeFormatInfo, que indican implícitamente un calendario.

Las operaciones que realizan los miembros del tipo DateTime tienen en cuenta una serie de detalles, como los años bisiestos y el número de días de un mes.

Los tipos de valor de DateTime y TimeSpan se diferencian en que DateTime representa un instante de tiempo, mientras que TimeSpan representa un intervalo de tiempo. Por ejemplo, esto significa que puede restar una instancia de DateTime de otra para obtener un objeto TimeSpan que representa el intervalo de tiempo entre ellas. O bien, podría sumar un valor TimeSpan positivo al valor DateTime actual para obtener un valor DateTime que representa una fecha futura.

Se puede agregar o restar un intervalo de tiempo a un objeto DateTime. Los intervalos de tiempo pueden ser negativos o positivos y se pueden expresar en unidades como pasos o segundos, o como objetos TimeSpan.

Se dice que un valor DateTime es de ida y vuelta cuando se transfiere a una aplicación COM y, a continuación, se vuelve a transferir a una aplicación administrada. Sin embargo, la acción de ida y vuelta de un valor de DateTime que especifique sólo una hora no tendrá el resultado que cabría esperar.

Si realiza la operación de ida y vuelta sólo una vez, por ejemplo, a las 3 p.m., la última fecha y hora es diciembre 30, 1899, d.C. a las 3:00 p.m., en lugar del 1 de enero de 0001 de la era cristiana. a las 3:00 p.m. Esto ocurre porque .NET Framework y COM suponen una fecha predeterminada cuando se especifica una sola vez. Sin embargo, el sistema COM supone como fecha base el 30 de diciembre de 1899 de la Era Cristiana. mientras que .NET Framework supone que la fecha base es el 1 de enero de 0001 de la Era Cristiana.

Cuando sólo se pasa una hora de .NET Framework a COM, se realiza un proceso especial que convierte la hora al formato utilizado por COM. Cuando sólo una vez se pasa de COM a .NET Framework, no se realiza ningún procesamiento especial debido a que podrían dañar las fechas y horas legítimas durante o antes del 30 de diciembre de 1899. Esto también significa que si una fecha comienza una acción de ida y vuelta empezando en COM, .NET Framework y COM conservan la fecha.

El comportamiento de .NET Framework y COM supone que si la aplicación ejecuta una acción de ida y vuelta respecto de un objeto DateTime que sólo especifica una hora, la aplicación no puede olvidarse de modificar u omitir los datos erróneos provenientes del objeto DateTime final.