DateTimeFormatInfo Classe

Definizione

Fornisce informazioni specifiche delle impostazioni cultura relative al 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 usata la reflection per ottenere le proprietà dell'oggetto DateTimeFormatInfo per le impostazioni cultura inglese (Stati Uniti). Visualizza il valore di queste proprietà che contengono stringhe di formato personalizzate e usa queste 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 api supplementari per DateTimeFormatInfo.

Costruttori

DateTimeFormatInfo()

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

Proprietà

AbbreviatedDayNames

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

AbbreviatedMonthGenitiveNames

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

AbbreviatedMonthNames

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

AMDesignator

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

Calendar

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

CalendarWeekRule

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

CurrentInfo

Ottiene un oggetto DateTimeFormatInfo di sola 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 stringa unidimensionale contenente i nomi estesi dei giorni della settimana specifici delle impostazioni cultura.

FirstDayOfWeek

Ottiene o imposta il primo giorno della settimana.

FullDateTimePattern

Ottiene o imposta la stringa di formato personalizzata per un valore di data e ora estese.

InvariantInfo

Ottiene l'oggetto DateTimeFormatInfo predefinito in sola lettura indipendente dalle impostazioni cultura associate alla lingua inglese.

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 ora estesa.

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 associata all'oggetto DateTimeFormatInfo corrente.

MonthNames

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

NativeCalendarName

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

PMDesignator

Ottiene o imposta l'indicatore di stringa per le ore "post meridiem" (dopo mezzogiorno).

RFC1123Pattern

Ottiene la stringa di formato personalizzata per un valore di data e ora basato sulla specifica IETF (Internet Engineering Task Force) RFC (Request for Comments) 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 univoci dei giorni abbreviati più corti associati all'oggetto DateTimeFormatInfo corrente.

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 ordinabile di data e ora.

TimeSeparator

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

UniversalSortableDateTimePattern

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

YearMonthPattern

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

Metodi

Clone()

Crea una copia superficiale di 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 della settimana specificato in base alle impostazioni cultura associate all'oggetto DateTimeFormatInfo corrente.

GetAbbreviatedEraName(Int32)

Restituisce la stringa contenente il nome abbreviato dell'era specificata, a condizione che esista un'abbreviazione.

GetAbbreviatedMonthName(Int32)

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

GetAllDateTimePatterns()

Restituisce tutti i modelli standard nei quali possono essere formattati i valori di data e ora.

GetAllDateTimePatterns(Char)

Restituisce tutti i modelli standard nei quali possono essere formattati i valori di data e ora mediante la stringa di formato standard specificato.

GetDayName(DayOfWeek)

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

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 data e ora.

GetHashCode()

Funge da funzione hash predefinita.

(Ereditato da Object)
GetInstance(IFormatProvider)

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

GetMonthName(Int32)

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

GetShortestDayName(DayOfWeek)

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

GetType()

Ottiene l'oggetto Type dell'istanza corrente.

(Ereditato da Object)
MemberwiseClone()

Crea una copia superficiale dell'oggetto Object corrente.

(Ereditato da Object)
ReadOnly(DateTimeFormatInfo)

Restituisce un wrapper DateTimeFormatInfo di sola lettura.

SetAllDateTimePatterns(String[], Char)

Imposta le stringhe di formato di data e ora 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

ISerializable.GetObjectData(SerializationInfo, StreamingContext)

Popola un elemento SerializationInfo con i dati necessari per la serializzazione dell'oggetto di destinazione.

Si applica a

Vedi anche