DateTimeFormatInfo Classe

Definizione

Spazio dei nomi:

System.Globalization

Assembly:

System.Runtime.dll

Origine:

DateTimeFormatInfo.cs

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

public ref class DateTimeFormatInfo sealed : ICloneable, IFormatProvider

public sealed class DateTimeFormatInfo : ICloneable, IFormatProvider

type DateTimeFormatInfo = class
    interface ICloneable
    interface IFormatProvider

Public NotInheritable Class DateTimeFormatInfo
Implements ICloneable, IFormatProvider

Ereditarietà

Object

DateTimeFormatInfo

Implementazioni

IFormatProvider ICloneable

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)

Vedi anche

• DateTime
• Calendar
• CultureInfo