DateTime.ToLongTimeString DateTime.ToLongTimeString DateTime.ToLongTimeString DateTime.ToLongTimeString Method

Definición

Convierte el valor del objeto DateTime actual en su representación de cadena de hora larga equivalente.Converts the value of the current DateTime object to its equivalent long time string representation.

public:
 System::String ^ ToLongTimeString();
public string ToLongTimeString ();
member this.ToLongTimeString : unit -> string
Public Function ToLongTimeString () As String

Devoluciones

Una cadena que contiene la representación de cadena de hora larga del objeto DateTime actual.A string that contains the long time string representation of the current DateTime object.

Ejemplos

En el ejemplo siguiente se muestra el ToLongTimeString método.The following example demonstrates the ToLongTimeString method.

using System;
using System.Threading;
using System.Globalization;

public class Sample 
{
   public static void Main() 
   {
      // Create an array of culture names.
      String[] names = { "en-US", "en-GB", "fr-FR", "de-DE" };
      // Initialize a DateTime object.
      DateTime dateValue = new System.DateTime(2013, 5, 28, 10, 30, 15);

      // Iterate the array of culture names.
      foreach (var name in names) {
         // Change the culture of the current thread.
         Thread.CurrentThread.CurrentCulture = CultureInfo.CreateSpecificCulture(name);
         // Display the name of the current culture and the date.
         Console.WriteLine("Current culture: {0}", CultureInfo.CurrentCulture.Name);
         Console.WriteLine("Date: {0:G}", dateValue);        

         // Display the long time pattern and the long time.
         Console.WriteLine("Long time pattern: '{0}'", 
                           DateTimeFormatInfo.CurrentInfo.LongTimePattern);
         Console.WriteLine("Long time with format string:     {0:T}", dateValue);
         Console.WriteLine("Long time with ToLongTimeString:  {0}\n", 
                           dateValue.ToLongTimeString());
      }
   }
}
// The example displays the following output:
//       Current culture: en-US
//       Date: 5/28/2013 10:30:15 AM
//       Long time pattern: 'h:mm:ss tt'
//       Long time with format string:     10:30:15 AM
//       Long time with ToLongTimeString:  10:30:15 AM
//       
//       Current culture: en-GB
//       Date: 28/05/2013 10:30:15
//       Long time pattern: 'HH:mm:ss'
//       Long time with format string:     10:30:15
//       Long time with ToLongTimeString:  10:30:15
//       
//       Current culture: fr-FR
//       Date: 28/05/2013 10:30:15
//       Long time pattern: 'HH:mm:ss'
//       Long time with format string:     10:30:15
//       Long time with ToLongTimeString:  10:30:15
//       
//       Current culture: de-DE
//       Date: 28.05.2013 10:30:15
//       Long time pattern: 'HH:mm:ss'
//       Long time with format string:     10:30:15
//       Long time with ToLongTimeString:  10:30:15
Imports System.Threading
Imports System.Globalization

Public Class Example
   Public Shared Sub Main() 
      ' Create an array of culture names.
      Dim names() As String = { "en-US", "en-GB", "fr-FR", "de-DE" }
      ' Initialize a DateTime object.
      Dim dateValue As New DateTime(2013, 5, 28, 10, 30, 15)
        
      ' Iterate the array of culture names.
      For Each name In names
         ' Change the culture of the current thread.
         Thread.CurrentThread.CurrentCulture = CultureInfo.CreateSpecificCulture(name)
         ' Display the name of the current culture and the date.
         Console.WriteLine("Current culture: {0}", CultureInfo.CurrentCulture.Name)
         Console.WriteLine("Date: {0:G}", dateValue)        

         ' Display the long time pattern and the long time.
         Console.WriteLine("Long time pattern: '{0}'", DateTimeFormatInfo.CurrentInfo.LongTimePattern)
         Console.WriteLine("Long time with format string:     {0:T}", dateValue)
         Console.WriteLine("Long time with ToLongTimeString:  {0}", dateValue.ToLongTimeString())
         Console.WriteLine()
      Next
   End Sub 
End Class 
' The example displays the following output:
'       Current culture: en-US
'       Date: 5/28/2013 10:30:15 AM
'       Long time pattern: 'h:mm:ss tt'
'       Long time with format string:     10:30:15 AM
'       Long time with ToLongTimeString:  10:30:15 AM
'       
'       Current culture: en-GB
'       Date: 28/05/2013 10:30:15
'       Long time pattern: 'HH:mm:ss'
'       Long time with format string:     10:30:15
'       Long time with ToLongTimeString:  10:30:15
'       
'       Current culture: fr-FR
'       Date: 28/05/2013 10:30:15
'       Long time pattern: 'HH:mm:ss'
'       Long time with format string:     10:30:15
'       Long time with ToLongTimeString:  10:30:15
'       
'       Current culture: de-DE
'       Date: 28.05.2013 10:30:15
'       Long time pattern: 'HH:mm:ss'
'       Long time with format string:     10:30:15
'       Long time with ToLongTimeString:  10:30:15

Comentarios

El valor del elemento actual DateTime objeto tiene el formato con el patrón definido por el DateTimeFormatInfo.LongTimePattern propiedad asociada con la referencia cultural del subproceso actual.The value of the current DateTime object is formatted using the pattern defined by the DateTimeFormatInfo.LongTimePattern property associated with the current thread culture. El valor devuelto es idéntico al valor devuelto mediante la especificación de la "T" cadena de formato de fecha y hora estándar con el ToString(String) método.The return value is identical to the value returned by specifying the "T" standard date and time format string with the ToString(String) method.

Nota

La cadena devuelta por la ToLongTimeString método es la referencia cultural.The string returned by the ToLongTimeString method is culture-sensitive. Refleja el patrón definido por la referencia cultural actual DateTimeFormatInfo.LongTimePattern propiedad.It reflects the pattern defined by the current culture's DateTimeFormatInfo.LongTimePattern property. Por ejemplo, la referencia cultural en-US, el patrón de hora larga estándar es "ss tt"; la referencia cultural de-DE, es "Hh"; la referencia cultural ja-JP, es "Ss".For example, for the en-US culture, the standard long time pattern is "h:mm:ss tt"; for the de-DE culture, it is "HH:mm:ss"; for the ja-JP culture, it is "H:mm:ss". Tenga en cuenta que su valor puede variar dependiendo de la implementación de .NET y su versión, el sistema operativo y su versión y la personalización del usuario.Note that its value can vary depending on the .NET implementation and its version, the operating system and its version, and user customization.

Para obtener más información acerca de la referencia cultural del subproceso actual, vea las propiedades CultureInfo.CurrentCulture y Thread.CurrentCulture.For more information about the current thread culture, see the CultureInfo.CurrentCulture and Thread.CurrentCulture properties. Para obtener más información acerca de los caracteres de formato, modelos de formato y la salida que generan, consulte Cadenas con formato de fecha y hora estándar y Cadenas con formato de fecha y hora personalizado.For more information about format characters, format patterns, and the output they produce, see Standard date and time format strings and Custom date and time format strings. Para obtener más información acerca de cómo cambiar el modelo de formato asociado a un carácter de formato, vea la clase DateTimeFormatInfo.For more information about changing the format pattern associated with a format character, see the DateTimeFormatInfo class.

Se aplica a

Consulte también: