DateTimeOffset.Date Proprietà

Definizione

Ottiene un valore DateTime che rappresenta il componente relativo alla data dell'oggetto DateTimeOffset corrente.Gets a DateTime value that represents the date component of the current DateTimeOffset object.

public:
 property DateTime Date { DateTime get(); };
public DateTime Date { get; }
member this.Date : DateTime
Public ReadOnly Property Date As DateTime

Valore della proprietà

Valore DateTime che rappresenta il componente relativo alla data dell'oggetto DateTimeOffset corrente.A DateTime value that represents the date component of the current DateTimeOffset object.

Esempi

Nell'esempio seguente viene recuperato il valore della proprietà Date per una data specifica.The following example retrieves the value of the Date property for a specific date. Il valore viene quindi visualizzato nella console utilizzando alcuni identificatori di formato di sola data standard e personalizzati.It then displays that value to the console using some standard and custom date-only format specifiers.

// Illustrate Date property and date formatting
DateTimeOffset thisDate = new DateTimeOffset(2008, 3, 17, 1, 32, 0, new TimeSpan(-5, 0, 0));
string fmt;                      // format specifier

// Display date only using "D" format specifier
// For en-us culture, displays:
//   'D' format specifier: Monday, March 17, 2008
fmt = "D";
Console.WriteLine("'{0}' format specifier: {1}",  
                  fmt, thisDate.Date.ToString(fmt));

// Display date only using "d" format specifier
// For en-us culture, displays:
//   'd' format specifier: 3/17/2008
fmt = "d";
Console.WriteLine("'{0}' format specifier: {1}",  
                  fmt, thisDate.Date.ToString(fmt));

// Display date only using "Y" (or "y") format specifier
// For en-us culture, displays:
//   'Y' format specifier: March, 2008
fmt = "Y";
Console.WriteLine("'{0}' format specifier: {1}",  
                  fmt, thisDate.Date.ToString(fmt));
                  
// Display date only using custom format specifier
// For en-us culture, displays:
//   'dd MMM yyyy' format specifier: 17 Mar 2008
fmt = "dd MMM yyyy";
Console.WriteLine("'{0}' format specifier: {1}",  
                  fmt, thisDate.Date.ToString(fmt));
' Illustrate Date property and date formatting
Dim thisDate As New DateTimeOffset(#3/17/2008 1:32AM#, New TimeSpan(-5, 0, 0))
Dim fmt As String                    ' format specifier
' Display date only using "D" format specifier
' For en-us culture, displays:
'   'D' format specifier: Monday, March 17, 2008
fmt = "D"
Console.WriteLine("'{0}' format specifier: {1}", _ 
                  fmt, thisDate.Date.ToString(fmt))

' Display date only using "d" format specifier
' For en-us culture, displays:
'   'd' format specifier: 3/17/2008
fmt = "d"
Console.WriteLine("'{0}' format specifier: {1}", _ 
                  fmt, thisDate.Date.ToString(fmt))

' Display date only using "Y" (or "y") format specifier
' For en-us culture, displays:
'   'Y' format specifier: March, 2008
fmt = "Y"
Console.WriteLine("'{0}' format specifier: {1}", _ 
                  fmt, thisDate.Date.ToString(fmt))
                  
' Display date only using custom format specifier
' For en-us culture, displays:
'   'dd MMM yyyy' format specifier: 17 Mar 2008
fmt = "dd MMM yyyy"
Console.WriteLine("'{0}' format specifier: {1}", _ 
                  fmt, thisDate.Date.ToString(fmt))

Commenti

Questa proprietà rimuove qualsiasi parte significativa del componente ora da un oggetto DateTimeOffset e restituisce solo il relativo componente di data significativo.This property removes any significant part of the time component from a DateTimeOffset object and returns only its significant date component. Se ad esempio l'oggetto DateTimeOffset dispone di un valore di data e ora di "1/12/07 4:01pm + 7:30", la proprietà restituisce un valore DateTime "1/12/07 12:00:00 AM".For example, if the DateTimeOffset object has a date and time value of "1/12/07 4:01pm +7:30", the property returns a DateTime value of "1/12/07 12:00:00 AM". Il valore di DateTime può quindi essere visualizzato utilizzando uno degli identificatori di formato standard o personalizzati che visualizzano solo le date.The DateTime value can then be displayed by using any of the standard or custom format specifiers that display dates only. Per un'illustrazione, vedere la sezione relativa agli esempi.(See the Example section for an illustration.)

Il valore della proprietà DateTime.Kind dell'oggetto DateTime restituito è sempre DateTimeKind.Unspecified.The value of the DateTime.Kind property of the returned DateTime object is always DateTimeKind.Unspecified. Non è influenzato dal valore della proprietà Offset.It is not affected by the value of the Offset property.

Per visualizzare una data senza il relativo componente temporale, è anche possibile usare gli identificatori di formato "D" o "d"; per un'illustrazione, vedere la sezione relativa agli esempi.To display a date without its time component, you can also use the "D" or "d" format specifiers; for an illustration, see the Example section.

Si applica a

Vedi anche