DateTimeOffset Struktura

Definice

public value class DateTimeOffset : IComparable, IComparable<DateTimeOffset>, IEquatable<DateTimeOffset>, IFormattable

public value class DateTimeOffset : IComparable, IComparable<DateTimeOffset>, IEquatable<DateTimeOffset>, IFormattable, System::Runtime::Serialization::IDeserializationCallback, System::Runtime::Serialization::ISerializable

public value class DateTimeOffset : IComparable, IComparable<DateTimeOffset>, IEquatable<DateTimeOffset>, ISpanFormattable, System::Runtime::Serialization::IDeserializationCallback, System::Runtime::Serialization::ISerializable

public value class DateTimeOffset : IComparable, IComparable<DateTimeOffset>, IEquatable<DateTimeOffset>, IParsable<DateTimeOffset>, ISpanFormattable, ISpanParsable<DateTimeOffset>, System::Runtime::Serialization::IDeserializationCallback, System::Runtime::Serialization::ISerializable

public value class DateTimeOffset : IComparable, IComparable<DateTimeOffset>, IEquatable<DateTimeOffset>, IParsable<DateTimeOffset>, ISpanFormattable, ISpanParsable<DateTimeOffset>, IUtf8SpanFormattable, System::Runtime::Serialization::IDeserializationCallback, System::Runtime::Serialization::ISerializable

public struct DateTimeOffset : IComparable, IComparable<DateTimeOffset>, IEquatable<DateTimeOffset>, IFormattable

public readonly struct DateTimeOffset : IComparable, IComparable<DateTimeOffset>, IEquatable<DateTimeOffset>, IFormattable, System.Runtime.Serialization.IDeserializationCallback, System.Runtime.Serialization.ISerializable

public readonly struct DateTimeOffset : IComparable, IComparable<DateTimeOffset>, IEquatable<DateTimeOffset>, ISpanFormattable, System.Runtime.Serialization.IDeserializationCallback, System.Runtime.Serialization.ISerializable

public readonly struct DateTimeOffset : IComparable, IComparable<DateTimeOffset>, IEquatable<DateTimeOffset>, IParsable<DateTimeOffset>, ISpanFormattable, ISpanParsable<DateTimeOffset>, System.Runtime.Serialization.IDeserializationCallback, System.Runtime.Serialization.ISerializable

public readonly struct DateTimeOffset : IComparable, IComparable<DateTimeOffset>, IEquatable<DateTimeOffset>, IParsable<DateTimeOffset>, ISpanFormattable, ISpanParsable<DateTimeOffset>, IUtf8SpanFormattable, System.Runtime.Serialization.IDeserializationCallback, System.Runtime.Serialization.ISerializable

public struct DateTimeOffset : IComparable, IComparable<DateTimeOffset>, IEquatable<DateTimeOffset>, IFormattable, System.Runtime.Serialization.IDeserializationCallback, System.Runtime.Serialization.ISerializable

[System.Serializable]
public struct DateTimeOffset : IComparable, IComparable<DateTimeOffset>, IEquatable<DateTimeOffset>, IFormattable, System.Runtime.Serialization.IDeserializationCallback, System.Runtime.Serialization.ISerializable

type DateTimeOffset = struct
    interface IFormattable

type DateTimeOffset = struct
    interface IFormattable
    interface IDeserializationCallback
    interface ISerializable

type DateTimeOffset = struct
    interface ISpanFormattable
    interface IFormattable
    interface IDeserializationCallback
    interface ISerializable

type DateTimeOffset = struct
    interface IFormattable
    interface IParsable<DateTimeOffset>
    interface ISpanFormattable
    interface ISpanParsable<DateTimeOffset>
    interface IDeserializationCallback
    interface ISerializable

type DateTimeOffset = struct
    interface IFormattable
    interface IParsable<DateTimeOffset>
    interface ISpanFormattable
    interface ISpanParsable<DateTimeOffset>
    interface IDeserializationCallback
    interface ISerializable
    interface IUtf8SpanFormattable

type DateTimeOffset = struct
    interface IFormattable
    interface IParsable<DateTimeOffset>
    interface ISpanFormattable
    interface ISpanParsable<DateTimeOffset>
    interface IUtf8SpanFormattable
    interface IDeserializationCallback
    interface ISerializable

[<System.Serializable>]
type DateTimeOffset = struct
    interface IFormattable
    interface ISerializable
    interface IDeserializationCallback

Public Structure DateTimeOffset
Implements IComparable, IComparable(Of DateTimeOffset), IEquatable(Of DateTimeOffset), IFormattable

Public Structure DateTimeOffset
Implements IComparable, IComparable(Of DateTimeOffset), IDeserializationCallback, IEquatable(Of DateTimeOffset), IFormattable, ISerializable

Public Structure DateTimeOffset
Implements IComparable, IComparable(Of DateTimeOffset), IDeserializationCallback, IEquatable(Of DateTimeOffset), ISerializable, ISpanFormattable

Public Structure DateTimeOffset
Implements IComparable, IComparable(Of DateTimeOffset), IDeserializationCallback, IEquatable(Of DateTimeOffset), IParsable(Of DateTimeOffset), ISerializable, ISpanFormattable, ISpanParsable(Of DateTimeOffset)

Public Structure DateTimeOffset
Implements IComparable, IComparable(Of DateTimeOffset), IDeserializationCallback, IEquatable(Of DateTimeOffset), IParsable(Of DateTimeOffset), ISerializable, ISpanFormattable, ISpanParsable(Of DateTimeOffset), IUtf8SpanFormattable

Dědičnost

Object

ValueType

DateTimeOffset

Atributy

SerializableAttribute

Implementuje

IComparable IComparable<DateTimeOffset> IEquatable<DateTimeOffset> IFormattable IDeserializationCallback ISerializable ISpanFormattable IParsable<DateTimeOffset> IParsable<TSelf> ISpanParsable<DateTimeOffset> IUtf8SpanFormattable

Poznámky

Struktura DateTimeOffset obsahuje DateTime hodnotu spolu s Offset vlastností, která definuje rozdíl mezi datem a časem aktuální DateTimeOffset instance a koordinovaným univerzálním časem (UTC). Vzhledem k tomu, že přesně definuje datum a čas vzhledem k času UTC, DateTimeOffset struktura neobsahuje Kind člena jako DateTime struktura. Představuje kalendářní data a časy s hodnotami, jejichž UTC je v rozsahu od 12:00:00 půlnoci, 1. ledna 0001 Anno Domini (společná éra) do 23:59:59, 31. prosince 9999 A.D. (C.E.).

Časová složka DateTimeOffset hodnoty se měří ve 100 nanosekundových jednotkách označovaných jako ticky a konkrétní datum je počet značek od 12:00 půlnoci 1. ledna 0001 n.d. (C.E.) v GregorianCalendar kalendáři. Hodnota DateTimeOffset je vždy vyjádřena v kontextu explicitního nebo výchozího kalendáře. Značky připadající na přestupné sekundy se do celkového počtu značek nezapočítávají.

DateTimeOffset I když hodnota zahrnuje posun, nejedná se o datovou strukturu plně pracující s časovými pásmy. I když je posun od času UTC jednou z charakteristik časového pásma, jednoznačně ho neidentifikuje. Nejen, že několik časových pásem sdílí stejný posun oproti UTC, ale posun jednoho časového pásma se změní, pokud zaznamená letní čas. To znamená, že jakmile DateTimeOffset je hodnota odpojena od svého časového pásma, nelze ji jednoznačně propojit zpět s původním časovým pásmem.

Protože DateTimeOffset je struktura, objekt, DateTimeOffset který byl deklarován, ale jinak inicializován, obsahuje výchozí hodnoty pro každé z jeho členských polí. To znamená, že jeho DateTime vlastnost je nastavená na DateTimeOffset.MinValue a vlastnost Offset je nastavená na TimeSpan.Zero.

Novou DateTimeOffset hodnotu můžete vytvořit zavoláním libovolného přetížení jeho konstruktoru, které jsou podobné přetíženým konstruktorům DateTime pro strukturu. Novou hodnotu můžete vytvořit DateTimeOffset také tak, že jí přiřadíte DateTime hodnotu. Jedná se o implicitní převod; nevyžaduje operátor přetypování (v jazyce C#) ani volání metody převodu (v jazyce Visual Basic). Můžete také inicializovat DateTimeOffset hodnotu z řetězcového vyjádření data a času voláním řady metod analýzy statických řetězců, mezi které patří Parse, ParseExactTryParse, a TryParseExact.

Členy DateTimeOffset struktury poskytují funkce v následujících oblastech:

• Aritmetika data a času

  K určité DateTimeOffset hodnotě můžete přičíst nebo odečíst kalendářní data nebo časové intervaly. Aritmetické operace s DateTimeOffset hodnotami, na rozdíl od těch s DateTime hodnotami, se při vracení výsledku upravují o rozdíly v časovém posunu. Následující kód například používá DateTime proměnné k odečtení aktuálního místního času od aktuálního času UTC. Kód pak použije DateTimeOffset proměnné k provedení stejné operace. Odčítání s DateTime hodnotami vrátí rozdíl místního časového pásma od času UTC, zatímco odčítání s DateTimeOffset hodnotami vrátí TimeSpan.Zerohodnotu .

  using System;
  
  public class DateArithmetic
  {
     public static void Main()
     {
        DateTime date1, date2;
        DateTimeOffset dateOffset1, dateOffset2;
        TimeSpan difference;
  
        // Find difference between Date.Now and Date.UtcNow
        date1 = DateTime.Now;
        date2 = DateTime.UtcNow;
        difference = date1 - date2;
        Console.WriteLine("{0} - {1} = {2}", date1, date2, difference);
  
        // Find difference between Now and UtcNow using DateTimeOffset
        dateOffset1 = DateTimeOffset.Now;
        dateOffset2 = DateTimeOffset.UtcNow;
        difference = dateOffset1 - dateOffset2;
        Console.WriteLine("{0} - {1} = {2}",
                          dateOffset1, dateOffset2, difference);
        // If run in the Pacific Standard time zone on 4/2/2007, the example
        // displays the following output to the console:
        //    4/2/2007 7:23:57 PM - 4/3/2007 2:23:57 AM = -07:00:00
        //    4/2/2007 7:23:57 PM -07:00 - 4/3/2007 2:23:57 AM +00:00 = 00:00:00
     }
  }
  

  open System
  
  // Find difference between Date.Now and Date.UtcNow
  let date1 = DateTime.Now
  let date2 = DateTime.UtcNow
  let difference1 = date1 - date2
  printfn $"{date1} - {date2} = {difference1}"
  
  // Find difference between Now and UtcNow using DateTimeOffset
  let dateOffset1 = DateTimeOffset.Now
  let dateOffset2 = DateTimeOffset.UtcNow
  let difference2 = dateOffset1 - dateOffset2
  printfn $"{dateOffset1} - {dateOffset2} = {difference2}"
                   
  // If run in the Pacific Standard time zone on 1/7/2022, the example
  // displays the following output to the console:
  //    1/7/2022 6:45:10 PM - 1/8/2022 2:45:10 AM = -08:00:00.0072573
  //    1/7/2022 6:45:10 PM -08:00 - 1/8/2022 2:45:10 AM +00:00 = -00:00:00.0000278
  

  Module DateArithmetic
     Public Sub Main()
        Dim date1, date2 As Date
        Dim dateOffset1, dateOffset2 As DateTimeOffset
        Dim difference As TimeSpan
        
        ' Find difference between Date.Now and Date.UtcNow
        date1 = Date.Now
        date2 = Date.UtcNow
        difference = date1 - date2
        Console.WriteLine("{0} - {1} = {2}", date1, date2, difference)
        
        ' Find difference between Now and UtcNow using DateTimeOffset
        dateOffset1 = date.Now
        dateOffset2 = date.UtcNow
        difference = dateOffset1 - dateOffset2
        Console.WriteLine("{0} - {1} = {2}", _
                          dateOffset1, dateOffset2, difference)
        ' If run in the Pacific Standard time zone on 4/2/2007, the example
        ' displays the following output to the console:
        '    4/2/2007 7:23:57 PM - 4/3/2007 2:23:57 AM = -07:00:00
        '    4/2/2007 7:23:57 PM -07:00 - 4/3/2007 2:23:57 AM +00:00 = 00:00:00                        
     End Sub
  End Module
  

• Operace převodu typů.

  Hodnoty můžete převést DateTimeOffset na DateTime hodnoty a naopak.

• Operace manipulace s časem a extrakce.

  Můžete extrahovat datum nebo čas DateTimeOffset hodnoty. Můžete také načíst hodnotu konkrétní DateTimeOffset komponenty, například rok nebo měsíc.

• Převod data a času.

  Libovolnou DateTimeOffset hodnotu můžete převést na jinou DateTimeOffset hodnotu, která představuje stejný bod v čase v jiném časovém pásmu. Pravidla úprav časového pásma se však použijí pouze v případě ToLocalTime metody, která převádí DateTimeOffset hodnotu na datum a čas v místní systémové zóně.

• Porovnání data a času

  Můžete určit, zda je některá konkrétní DateTimeOffset hodnota dřívější než, stejná jako nebo novější než jiná DateTimeOffset hodnota. Před provedením porovnání se všechny hodnoty převedou do standardu UTC.

Konstruktory

Pole

Vlastnosti

Metody

Operátory

Explicitní implementace rozhraní

Platí pro

Viz také

• Volba mezi hodnotami DateTime, DateTimeOffset, TimeSpan a TimeZoneInfo
• Ukázka: .NET Core – nástroj pro formátování WinForms (C#)
• Ukázka: .NET Core WinForms Formatting Utility (Visual Basic)