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 sull'API supplementare per DateTimeFormatInfo.

Costruttori

DateTimeFormatInfo()

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

Proprietà

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 DateTimeFormatInfo corrente.

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 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 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 DateTimeFormatInfo di sola 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 DateTimeFormatInfo corrente.

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 DateTimeFormatInfo corrente.

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 di giorno abbreviati univoci più brevi 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 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

Clone()

Crea una copia superficiale del 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 DateTimeFormatInfo corrente.

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 DateTimeFormatInfo corrente.

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

GetHashCode()

Funge da funzione hash predefinita.

(Ereditato da Object)
GetInstance(IFormatProvider)

Restituisce l'oggetto DateTimeFormatInfo associato al IFormatProviderspecificato.

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ù breve per un giorno specificato della settimana associato all'oggetto DateTimeFormatInfo corrente.

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

ISerializable.GetObjectData(SerializationInfo, StreamingContext)

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

Si applica a

Vedi anche