DateTimeFormatInfo Classe

Definizione

Fornisce informazioni specifiche delle impostazioni cultura sul formato dei valori di data e ora.

public ref class DateTimeFormatInfo sealed : IFormatProvider
public ref class DateTimeFormatInfo sealed : ICloneable, IFormatProvider
public ref class DateTimeFormatInfo sealed : ICloneable, IFormatProvider, System::Runtime::Serialization::ISerializable
public sealed class DateTimeFormatInfo : IFormatProvider
public sealed class DateTimeFormatInfo : ICloneable, IFormatProvider
[System.Serializable]
public sealed class DateTimeFormatInfo : ICloneable, IFormatProvider, System.Runtime.Serialization.ISerializable
[System.Serializable]
[System.Runtime.InteropServices.ComVisible(true)]
public sealed class DateTimeFormatInfo : ICloneable, IFormatProvider
type DateTimeFormatInfo = class
    interface IFormatProvider
type DateTimeFormatInfo = class
    interface ICloneable
    interface IFormatProvider
[<System.Serializable>]
type DateTimeFormatInfo = class
    interface ICloneable
    interface IFormatProvider
    interface ISerializable
[<System.Serializable>]
[<System.Runtime.InteropServices.ComVisible(true)>]
type DateTimeFormatInfo = class
    interface ICloneable
    interface IFormatProvider
Public NotInheritable Class DateTimeFormatInfo
Implements IFormatProvider
Public NotInheritable Class DateTimeFormatInfo
Implements ICloneable, IFormatProvider
Public NotInheritable Class DateTimeFormatInfo
Implements ICloneable, IFormatProvider, ISerializable
Ereditarietà
DateTimeFormatInfo
Attributi
Implementazioni

Esempio

Nell'esempio seguente viene utilizzata la reflection per ottenere le proprietà dell'oggetto DateTimeFormatInfo per le impostazioni cultura inglese (Stati Uniti). Visualizza il valore di tali proprietà che contengono stringhe di formato personalizzate e usa tali stringhe per visualizzare le date formattate.

using System;
using System.Globalization;
using System.Reflection;

public class Example
{
   public static void Main()
   {
      // Get the properties of an en-US DateTimeFormatInfo object.
      DateTimeFormatInfo dtfi = CultureInfo.GetCultureInfo("en-US").DateTimeFormat;
      Type typ = dtfi.GetType();
      PropertyInfo[] props = typ.GetProperties();
      DateTime value = new DateTime(2012, 5, 28, 11, 35, 0);

      foreach (var prop in props) {
         // Is this a format pattern-related property?
         if (prop.Name.Contains("Pattern")) {
            string fmt = prop.GetValue(dtfi, null).ToString();
            Console.WriteLine("{0,-33} {1} \n{2,-37}Example: {3}\n",
                              prop.Name + ":", fmt, "",
                              value.ToString(fmt));
         }
      }
   }
}
// The example displays the following output:
//    FullDateTimePattern:              dddd, MMMM dd, yyyy h:mm:ss tt
//                                         Example: Monday, May 28, 2012 11:35:00 AM
//
//    LongDatePattern:                  dddd, MMMM dd, yyyy
//                                         Example: Monday, May 28, 2012
//
//    LongTimePattern:                  h:mm:ss tt
//                                         Example: 11:35:00 AM
//
//    MonthDayPattern:                  MMMM dd
//                                         Example: May 28
//
//    RFC1123Pattern:                   ddd, dd MMM yyyy HH':'mm':'ss 'GMT'
//                                         Example: Mon, 28 May 2012 11:35:00 GMT
//
//    ShortDatePattern:                 M/d/yyyy
//                                         Example: 5/28/2012
//
//    ShortTimePattern:                 h:mm tt
//                                         Example: 11:35 AM
//
//    SortableDateTimePattern:          yyyy'-'MM'-'dd'T'HH':'mm':'ss
//                                         Example: 2012-05-28T11:35:00
//
//    UniversalSortableDateTimePattern: yyyy'-'MM'-'dd HH':'mm':'ss'Z'
//                                         Example: 2012-05-28 11:35:00Z
//
//    YearMonthPattern:                 MMMM, yyyy
//                                         Example: May, 2012
Imports System.Globalization
Imports System.Reflection

Module Example
   Public Sub Main()
      ' Get the properties of an en-US DateTimeFormatInfo object.
      Dim dtfi As DateTimeFormatInfo = CultureInfo.GetCultureInfo("en-US").DateTimeFormat
      Dim typ As Type = dtfi.GetType()
      Dim props() As PropertyInfo = typ.GetProperties()
      Dim value As Date = #05/28/2012 11:35AM# 
      
      For Each prop In props
         ' Is this a format pattern-related property?
         If prop.Name.Contains("Pattern") Then
            Dim fmt As String = CStr(prop.GetValue(dtfi, Nothing))
            Console.WriteLine("{0,-33} {1} {2}{3,-37}Example: {4}", 
                              prop.Name + ":", fmt, vbCrLf, "",
                              value.ToString(fmt)) 
            Console.WriteLine()
         End If
      Next
   End Sub
End Module
' The example displays the following output:
'    FullDateTimePattern:              dddd, MMMM dd, yyyy h:mm:ss tt
'                                         Example: Monday, May 28, 2012 11:35:00 AM
'    
'    LongDatePattern:                  dddd, MMMM dd, yyyy
'                                         Example: Monday, May 28, 2012
'    
'    LongTimePattern:                  h:mm:ss tt
'                                         Example: 11:35:00 AM
'    
'    MonthDayPattern:                  MMMM dd
'                                         Example: May 28
'    
'    RFC1123Pattern:                   ddd, dd MMM yyyy HH':'mm':'ss 'GMT'
'                                         Example: Mon, 28 May 2012 11:35:00 GMT
'    
'    ShortDatePattern:                 M/d/yyyy
'                                         Example: 5/28/2012
'    
'    ShortTimePattern:                 h:mm tt
'                                         Example: 11:35 AM
'    
'    SortableDateTimePattern:          yyyy'-'MM'-'dd'T'HH':'mm':'ss
'                                         Example: 2012-05-28T11:35:00
'    
'    UniversalSortableDateTimePattern: yyyy'-'MM'-'dd HH':'mm':'ss'Z'
'                                         Example: 2012-05-28 11:35:00Z
'    
'    YearMonthPattern:                 MMMM, yyyy
'                                         Example: May, 2012

Commenti

Per altre informazioni su questa API, vedere Osservazioni supplementari sulle API per DateTimeFormatInfo.

Costruttori

Nome Descrizione
DateTimeFormatInfo()

Inizializza una nuova istanza scrivibile della DateTimeFormatInfo classe indipendente dalle impostazioni cultura (invariante).

Proprietà

Nome Descrizione
AbbreviatedDayNames

Ottiene o imposta una matrice unidimensionale di tipo String contenente i nomi abbreviati specifici delle impostazioni cultura dei giorni della settimana.

AbbreviatedMonthGenitiveNames

Ottiene o imposta una matrice di stringhe di nomi di mesi abbreviati associati all'oggetto corrente DateTimeFormatInfo .

AbbreviatedMonthNames

Ottiene o imposta una matrice di stringhe unidimensionale contenente i nomi abbreviati specifici delle impostazioni cultura dei mesi.

AMDesignator

Ottiene o imposta l'identificatore di stringa per ore "ante meridiem" (prima di mezzogiorno).

Calendar

Ottiene o imposta il calendario da utilizzare per le impostazioni cultura correnti.

CalendarWeekRule

Ottiene o imposta un valore che specifica la regola utilizzata per determinare la prima settimana di calendario dell'anno.

CurrentInfo

Ottiene un oggetto di sola DateTimeFormatInfo lettura che formatta i valori in base alle impostazioni cultura correnti.

DateSeparator

Ottiene o imposta la stringa che separa i componenti di una data, ovvero l'anno, il mese e il giorno.

DayNames

Ottiene o imposta una matrice di stringhe unidimensionale che contiene i nomi completi specifici delle impostazioni cultura dei giorni della settimana.

FirstDayOfWeek

Ottiene o imposta il primo giorno della settimana.

FullDateTimePattern

Ottiene o imposta la stringa di formato personalizzata per un valore long date e long time.

InvariantInfo

Ottiene l'oggetto di sola DateTimeFormatInfo lettura predefinito indipendente dalle impostazioni cultura (invariante).

IsReadOnly

Ottiene un valore che indica se l'oggetto DateTimeFormatInfo è di sola lettura.

LongDatePattern

Ottiene o imposta la stringa di formato personalizzata per un valore di data estesa.

LongTimePattern

Ottiene o imposta la stringa di formato personalizzata per un valore di tempo lungo.

MonthDayPattern

Ottiene o imposta la stringa di formato personalizzata per un valore di mese e giorno.

MonthGenitiveNames

Ottiene o imposta una matrice di stringhe di nomi di mesi associati all'oggetto corrente DateTimeFormatInfo .

MonthNames

Ottiene o imposta una matrice unidimensionale di tipo String contenente i nomi completi specifici delle impostazioni cultura dei mesi.

NativeCalendarName

Ottiene il nome nativo del calendario associato all'oggetto corrente DateTimeFormatInfo .

PMDesignator

Ottiene o imposta l'identificatore di stringa per ore che sono "post meridiem" (dopo mezzogiorno).

RFC1123Pattern

Ottiene la stringa di formato personalizzata per un valore di ora basato sulla specifica IETF (Internet Engineering Task Force) Request for Comments (RFC) 1123.

ShortDatePattern

Ottiene o imposta la stringa di formato personalizzata per un valore di data breve.

ShortestDayNames

Ottiene o imposta una matrice di stringhe dei nomi dei giorni abbreviati più brevi associati all'oggetto corrente DateTimeFormatInfo .

ShortTimePattern

Ottiene o imposta la stringa di formato personalizzata per un valore di ora breve.

SortableDateTimePattern

Ottiene la stringa di formato personalizzata per un valore di data e ora ordinabile.

TimeSeparator

Ottiene o imposta la stringa che separa i componenti di tempo, ovvero l'ora, i minuti e i secondi.

UniversalSortableDateTimePattern

Ottiene la stringa di formato personalizzata per una stringa di data e ora ordinabile universale, come definito da ISO 8601.

YearMonthPattern

Ottiene o imposta la stringa di formato personalizzata per un valore anno e mese.

Metodi

Nome Descrizione
Clone()

Crea una copia superficiale dell'oggetto DateTimeFormatInfo.

Equals(Object)

Determina se l'oggetto specificato è uguale all'oggetto corrente.

(Ereditato da Object)
GetAbbreviatedDayName(DayOfWeek)

Restituisce il nome abbreviato specifico delle impostazioni cultura del giorno specificato della settimana in base alle impostazioni cultura associate all'oggetto corrente DateTimeFormatInfo .

GetAbbreviatedEraName(Int32)

Restituisce la stringa contenente il nome abbreviato dell'era specificata, se esiste un'abbreviazione.

GetAbbreviatedMonthName(Int32)

Restituisce il nome abbreviato specifico delle impostazioni cultura del mese specificato in base alle impostazioni cultura associate all'oggetto corrente DateTimeFormatInfo .

GetAllDateTimePatterns()

Restituisce tutti i modelli standard in cui è possibile formattare i valori di data e ora.

GetAllDateTimePatterns(Char)

Restituisce tutti i modelli in cui è possibile formattare i valori di data e ora usando la stringa di formato standard specificata.

GetDayName(DayOfWeek)

Restituisce il nome completo specifico delle impostazioni cultura del giorno specificato della settimana in base alle impostazioni cultura associate all'oggetto corrente DateTimeFormatInfo .

GetEra(String)

Restituisce l'intero che rappresenta l'era specificata.

GetEraName(Int32)

Restituisce la stringa contenente il nome dell'era specificata.

GetFormat(Type)

Restituisce un oggetto del tipo specificato che fornisce un servizio di formattazione di data e ora.

GetHashCode()

Funge da funzione hash predefinita.

(Ereditato da Object)
GetInstance(IFormatProvider)

Restituisce l'oggetto DateTimeFormatInfo associato all'oggetto specificato IFormatProvider.

GetMonthName(Int32)

Restituisce il nome completo specifico delle impostazioni cultura del mese specificato in base alle impostazioni cultura associate all'oggetto corrente DateTimeFormatInfo .

GetShortestDayName(DayOfWeek)

Ottiene il nome del giorno abbreviato più breve per un giorno specificato della settimana associato all'oggetto corrente DateTimeFormatInfo .

GetType()

Ottiene il Type dell'istanza corrente.

(Ereditato da Object)
MemberwiseClone()

Crea una copia superficiale del Objectcorrente.

(Ereditato da Object)
ReadOnly(DateTimeFormatInfo)

Restituisce un wrapper DateTimeFormatInfo di sola lettura.

SetAllDateTimePatterns(String[], Char)

Imposta le stringhe di formato di data e ora personalizzate che corrispondono a una stringa di formato standard specificata.

ToString()

Restituisce una stringa che rappresenta l'oggetto corrente.

(Ereditato da Object)

Implementazioni dell'interfaccia esplicita

Nome Descrizione
ISerializable.GetObjectData(SerializationInfo, StreamingContext)

Popola un Oggetto SerializationInfo con i dati necessari per serializzare l'oggetto di destinazione.

Si applica a

Vedi anche