通过


DateTimeOffset 结构

定义

表示相对于协调世界时(UTC)的时间点,通常表示为日期和时间。

public value class DateTimeOffset : IComparable, IComparable<DateTimeOffset>, IEquatable<DateTimeOffset>, IFormattable
public value class DateTimeOffset : IComparable, IComparable<DateTimeOffset>, IEquatable<DateTimeOffset>, IParsable<DateTimeOffset>, ISpanFormattable, ISpanParsable<DateTimeOffset>, IUtf8SpanFormattable, System::Runtime::Serialization::IDeserializationCallback, System::Runtime::Serialization::ISerializable
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 struct DateTimeOffset : IComparable, IComparable<DateTimeOffset>, IEquatable<DateTimeOffset>, IFormattable
public readonly struct DateTimeOffset : IComparable, IComparable<DateTimeOffset>, IEquatable<DateTimeOffset>, IParsable<DateTimeOffset>, ISpanFormattable, ISpanParsable<DateTimeOffset>, IUtf8SpanFormattable, System.Runtime.Serialization.IDeserializationCallback, System.Runtime.Serialization.ISerializable
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 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 IParsable<DateTimeOffset>
    interface ISpanFormattable
    interface ISpanParsable<DateTimeOffset>
    interface IUtf8SpanFormattable
    interface IDeserializationCallback
    interface ISerializable
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
[<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), IParsable(Of DateTimeOffset), ISerializable, ISpanFormattable, ISpanParsable(Of DateTimeOffset), IUtf8SpanFormattable
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)
继承
DateTimeOffset
属性
实现

注解

DateTimeOffset 结构包括一个 DateTime 值,以及一个 Offset 属性,用于定义当前 DateTimeOffset 实例的日期和时间与协调世界时(UTC)之间的差异。 因为它确切地定义了相对于 UTC 的日期和时间,因此该 DateTimeOffset 结构不包括成员 Kind ,就像结构一样 DateTime 。 它表示其 UTC 范围为 12:00:00 午夜、0001 年 1 月 1 日安诺多米尼(通用时代)到晚上 11:59:59 的日期和时间,9999 年 12 月 31 日,上午 9999 年 12 月 31 日(C.E.)。

重要

日本日历中的纪元基于皇帝的统治,因此预计将改变。 例如,2019 年 5 月 1 日在 JapaneseCalendarJapaneseLunisolarCalendar 中标志着令和年号的开始。 这种时代变化会影响使用这些日历的所有应用程序。 有关详细信息以及确定您的应用程序是否受到影响,请参阅 在 .NET 中处理日语日历的新纪元。 有关在 Windows 系统上测试应用程序以确保其为纪元更改做好准备的信息,请参阅 为日本时代更改准备应用程序。 有关支持具有多个纪元的日历以及处理支持多个纪元的日历的最佳做法的 .NET 中的功能,请参阅 “使用纪元”。

值的时间分量 DateTimeOffset 以 100 纳秒为单位测量,称为刻度,特定日期是日历中 GregorianCalendar 自 12:00 午夜 12:00 以来的刻度数(C.E.)。 值 DateTimeOffset 始终在显式日历或默认日历的上下文中表示。 因跃秒而归咎于跃秒的刻度数不包括在时钟周期总数中。

虽然值 DateTimeOffset 包含偏移量,但它不是完全时区感知的数据结构。 虽然 UTC 的偏移量是时区的一个特征,但它无法明确标识时区。 不仅多个时区与 UTC 共享相同的偏移量,而且如果出现夏令时,单个时区的偏移量会发生变化。 这意味着,一旦某个 DateTimeOffset 值与其时区取消关联,它就不能再明确地链接到其原始时区。

由于 DateTimeOffset 是一个结构, DateTimeOffset 因此已声明但未初始化的对象包含其每个成员字段的默认值。 这意味着其 DateTime 属性设置为 DateTimeOffset.MinValue ,并且其 Offset 属性设置为 TimeSpan.Zero

可以通过调用其构造函数的任何重载来 DateTimeOffset 创建新值,这些重载类似于结构的 DateTime 重载构造函数。 还可以通过为其分配值DateTimeDateTimeOffset创建新值。 这是隐式转换;它不需要转换运算符(在 C# 中)或调用转换方法(在 Visual Basic 中)。 还可以通过调用许多静态字符串分析方法(包括ParseParseExactTryParseExactTryParse)来初始化DateTimeOffset日期和时间的字符串表示形式中的值。

结构的成员 DateTimeOffset 在以下方面提供功能:

  • 日期和时间算术。

    可以从特定 DateTimeOffset 值添加或减去日期或时间间隔。 使用 DateTimeOffset 值的算术运算(与具有 DateTime 值的运算不同)在返回结果时根据时间偏移量的差异进行调整。 例如,以下代码使用 DateTime 变量从当前 UTC 时间减去当前本地时间。 然后,代码使用 DateTimeOffset 变量来执行相同的操作。 带 DateTime 值的减法返回本地时区与 UTC 的差值,而值 DateTimeOffset 返回 TimeSpan.Zero的减法。

    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
    
  • 类型转换操作。

    可以将值转换为DateTimeOffsetDateTime值,反之亦然。

  • 时间操作和提取操作。

    可以提取值的日期或时间 DateTimeOffset 。 还可以检索特定 DateTimeOffset 组件的值,例如其年份或月份。

    注释

    如果要使用要转换为某些其他时间间隔(如分钟或秒)的刻度值,则应使用 TimeSpan.TicksPerDayTimeSpan.TicksPerHourTimeSpan.TicksPerMinuteTimeSpan.TicksPerSecondTimeSpan.TicksPerMillisecond 常量来执行转换。 例如,若要将指定的刻度数所表示的秒数添加到 Second 值的组件 DateTimeOffset ,可以使用表达式 dateValue.Second + nTicks/Timespan.TicksPerSecond

  • 日期和时间转换。

    可以将任何 DateTimeOffset 值转换为另一 DateTimeOffset 个值,该值表示另一时区中的同一时间点。 但是,时区的调整规则仅在方法的情况下 ToLocalTime 应用,该方法将值转换为 DateTimeOffset 本地系统区域中的日期和时间。

  • 日期和时间比较。

    可以确定任何特定 DateTimeOffset 值是早于、相同还是晚于另一个 DateTimeOffset 值。 在执行比较之前,所有值将转换为 UTC。

构造函数

名称 说明
DateTimeOffset(DateOnly, TimeOnly, TimeSpan)

使用指定的 初始化结构的新实例

DateTimeOffset(DateTime, TimeSpan)

DateTimeOffset使用指定的DateTime值和 offset.

DateTimeOffset(DateTime)

使用指定的DateTime值初始化结构的新实例DateTimeOffset

DateTimeOffset(Int32, Int32, Int32, Int32, Int32, Int32, Int32, Calendar, TimeSpan)

使用指定的、、、、dayminutehoursecond、、 millisecondcalendaroffset来初始化结构的新实例DateTimeOffsetmonthyear

DateTimeOffset(Int32, Int32, Int32, Int32, Int32, Int32, Int32, Int32, Calendar, TimeSpan)

使用指定的yearmonthdaymillisecondhoursecondminutemicrosecond、 和offsetcalendar来初始化结构的新实例。DateTimeOffset

DateTimeOffset(Int32, Int32, Int32, Int32, Int32, Int32, Int32, Int32, TimeSpan)

使用指定的、、、、dayminutehoursecond、、 millisecondmicrosecondoffset来初始化结构的新实例DateTimeOffsetmonthyear

DateTimeOffset(Int32, Int32, Int32, Int32, Int32, Int32, Int32, TimeSpan)

使用指定的year、、monthdayhourminutesecondmillisecondoffset来初始化结构的新实例DateTimeOffset

DateTimeOffset(Int32, Int32, Int32, Int32, Int32, Int32, TimeSpan)

使用指定的year、、monthdayhourminute、和secondoffset初始化结构的新实例DateTimeOffset

DateTimeOffset(Int64, TimeSpan)

DateTimeOffset使用指定的数目ticksoffset

字段

名称 说明
MaxValue

表示最大可能的值 DateTimeOffset。 此字段是只读的。

MinValue

表示最早的值 DateTimeOffset 。 此字段是只读的。

UnixEpoch

此常量的值等效于 1970 年 1 月 1 日,公历中的 00:00:00.0000000 UTC。 UnixEpoch 定义 Unix 时间等于 0 的时间点。

属性

名称 说明
Date

获取一个 DateTime 值,该值表示当前 DateTimeOffset 对象的日期组件。

DateTime

获取一个 DateTime 值,该值表示当前 DateTimeOffset 对象的日期和时间。

Day

获取由当前 DateTimeOffset 对象表示的月份的日期。

DayOfWeek

获取由当前 DateTimeOffset 对象表示的一周中的一天。

DayOfYear

获取由当前 DateTimeOffset 对象表示的年份的日期。

Hour

获取由当前 DateTimeOffset 对象表示的时间的小时组件。

LocalDateTime

获取一个 DateTime 值,该值表示当前 DateTimeOffset 对象的本地日期和时间。

Microsecond

获取由当前 DateTimeOffset 对象表示的时间的微秒组件。

Millisecond

获取由当前 DateTimeOffset 对象表示的时间的毫秒部分。

Minute

获取由当前 DateTimeOffset 对象表示的时间的分钟分量。

Month

获取由当前 DateTimeOffset 对象表示的日期的月份组件。

Nanosecond

获取由当前 DateTimeOffset 对象表示的时间的 nanosecond 组件。

Now

获取一个 DateTimeOffset 对象,该对象设置为当前计算机上的当前日期和时间,其偏移量设置为本地时间与协调世界时(UTC) 的偏移量。

Offset

获取与协调世界时(UTC)的时间偏移量。

Second

获取由当前 DateTimeOffset 对象表示的时钟时间的第二个组件。

Ticks

获取表示当前 DateTimeOffset 对象的日期和时间(以时钟时间为单位)的时钟周期数。

TimeOfDay

获取当前 DateTimeOffset 对象的一天中的时间。

TotalOffsetMinutes

获取时间与协调世界时(UTC)的偏移量(以分钟为单位)。

UtcDateTime

获取一个 DateTime 值,该值表示当前 DateTimeOffset 对象的协调世界时(UTC)日期和时间。

UtcNow

获取一个 DateTimeOffset 对象,其日期和时间设置为当前协调世界时(UTC)日期和时间,其偏移量为 Zero

UtcTicks

获取表示当前 DateTimeOffset 对象在协调世界时(UTC)中的日期和时间的刻度数。

Year

获取由当前 DateTimeOffset 对象表示的日期的年份组件。

方法

名称 说明
Add(TimeSpan)

返回一个新 DateTimeOffset 对象,该对象将指定的时间间隔添加到此实例的值。

AddDays(Double)

返回一个新 DateTimeOffset 对象,该对象将指定的整数和小数天添加到此实例的值。

AddHours(Double)

返回一个新 DateTimeOffset 对象,该对象将指定数量的整数和小数小时添加到此实例的值。

AddMicroseconds(Double)

返回一个新 DateTimeOffset 对象,该对象将指定数量的微秒添加到此实例的值。

AddMilliseconds(Double)

返回一个新 DateTimeOffset 对象,该对象向此实例的值添加指定的毫秒数。

AddMinutes(Double)

返回一个新 DateTimeOffset 对象,该对象将指定数量的整数和小数分钟添加到此实例的值。

AddMonths(Int32)

返回一个新 DateTimeOffset 对象,该对象将指定月数添加到此实例的值。

AddSeconds(Double)

返回一个新 DateTimeOffset 对象,该对象将指定的整数和小数秒数添加到此实例的值。

AddTicks(Int64)

返回一个新 DateTimeOffset 对象,该对象将指定的时钟周期数添加到此实例的值。

AddYears(Int32)

返回一个新 DateTimeOffset 对象,该对象将指定年份添加到此实例的值。

Compare(DateTimeOffset, DateTimeOffset)

比较两个 DateTimeOffset 对象,并指示第一个对象是早于第二个对象,等于第二个对象还是晚于第二个对象。

CompareTo(DateTimeOffset)

将当前 DateTimeOffset 对象与指定的 DateTimeOffset 对象进行比较,并指示当前对象是早于、与第二个对象相同还是晚于第二个 DateTimeOffset 对象。

Deconstruct(DateOnly, TimeOnly, TimeSpan)

将此 DateTimeOffset 实例解构为 DateOnlyTimeOnlyTimeSpan

Equals(DateTimeOffset, DateTimeOffset)

确定两个指定的 DateTimeOffset 对象是否表示相同的时间点。

Equals(DateTimeOffset)

确定当前 DateTimeOffset 对象是否表示与指定 DateTimeOffset 对象相同的时间点。

Equals(Object)

确定对象 DateTimeOffset 是否表示与指定对象相同的时间点。

EqualsExact(DateTimeOffset)

确定当前 DateTimeOffset 对象是否表示同一时间,并且具有与指定 DateTimeOffset 对象相同的偏移量。

FromFileTime(Int64)

将指定的 Windows 文件时间转换为等效的本地时间。

FromUnixTimeMilliseconds(Int64)

将表示为自 1970-01-01-01T00:00:00Z 以来已用过的毫秒数的 Unix 时间转换为值 DateTimeOffset

FromUnixTimeSeconds(Int64)

将表示为自 1970-01-01-01T00:00:00Z 以来已用过的秒数的 Unix 时间转换为值 DateTimeOffset

GetHashCode()

返回当前 DateTimeOffset 对象的哈希代码。

Parse(ReadOnlySpan<Char>, IFormatProvider, DateTimeStyles)

使用指定的区域性特定格式信息和格式样式将日期和时间的指定范围表示形式转换为其 DateTimeOffset 等效的表示形式。

Parse(ReadOnlySpan<Char>, IFormatProvider)

将字符的范围分析为值。

Parse(String, IFormatProvider, DateTimeStyles)

使用指定的区域性特定格式信息和格式样式将日期和时间的指定字符串表示形式转换为等效 DateTimeOffset 的字符串表示形式。

Parse(String, IFormatProvider)

使用指定的区域性特定格式信息将日期和时间的指定字符串表示形式转换为等效 DateTimeOffset 的字符串表示形式。

Parse(String)

将日期、时间和偏移的指定字符串表示形式转换为等效 DateTimeOffset 的字符串表示形式。

ParseExact(ReadOnlySpan<Char>, ReadOnlySpan<Char>, IFormatProvider, DateTimeStyles)

使用指定的格式、区域性特定的格式信息和样式将表示日期和时间的字符范围转换为等效 DateTimeOffset 的字符范围。 日期和时间表示形式的格式必须与指定的格式完全匹配。

ParseExact(ReadOnlySpan<Char>, String[], IFormatProvider, DateTimeStyles)

使用指定的格式、区域性特定的格式信息和样式将包含日期和时间的字符串表示形式的字符范围转换为等效 DateTimeOffset 的字符范围。 日期和时间表示形式的格式必须与指定格式之一完全匹配。

ParseExact(String, String, IFormatProvider, DateTimeStyles)

使用指定的格式、区域性特定的格式信息和样式将日期和时间的指定字符串表示形式转换为等效 DateTimeOffset 的字符串表示形式。 字符串表示形式的格式必须与指定的格式完全匹配。

ParseExact(String, String, IFormatProvider)

使用指定的格式和区域性特定格式信息将日期和时间的指定字符串表示形式转换为等效 DateTimeOffset 的字符串表示形式。 字符串表示形式的格式必须与指定的格式完全匹配。

ParseExact(String, String[], IFormatProvider, DateTimeStyles)

使用指定的格式、区域性特定的格式信息和样式将日期和时间的指定字符串表示形式转换为等效 DateTimeOffset 的字符串表示形式。 字符串表示形式的格式必须与指定格式之一完全匹配。

Subtract(DateTimeOffset)

从当前DateTimeOffset对象中减去一个DateTimeOffset表示特定日期和时间的值。

Subtract(TimeSpan)

从当前 DateTimeOffset 对象中减去指定的时间间隔。

ToFileTime()

将当前 DateTimeOffset 对象的值转换为 Windows 文件时间。

ToLocalTime()

将当前 DateTimeOffset 对象转换为 DateTimeOffset 表示本地时间的对象。

ToOffset(TimeSpan)

将当前 DateTimeOffset 对象的值转换为偏移值指定的日期和时间。

ToString()

将当前 DateTimeOffset 对象的值转换为其等效的字符串表示形式。

ToString(IFormatProvider)

使用指定的区域性特定的格式设置信息将当前 DateTimeOffset 对象的值转换为其等效的字符串表示形式。

ToString(String, IFormatProvider)

使用指定的格式和区域性特定的格式信息将当前 DateTimeOffset 对象的值转换为其等效的字符串表示形式。

ToString(String)

使用指定的格式将当前 DateTimeOffset 对象的值转换为其等效的字符串表示形式。

ToUniversalTime()

将当前 DateTimeOffset 对象转换为 DateTimeOffset 表示协调世界时(UTC)的值。

ToUnixTimeMilliseconds()

返回自 1970-01-01T00:00:00:00.000Z 以来已用过的毫秒数。

ToUnixTimeSeconds()

返回自 1970-01-01T00:00:00Z 以来已用过的秒数。

TryFormat(Span<Byte>, Int32, ReadOnlySpan<Char>, IFormatProvider)

尝试将当前实例的值格式化为 UTF-8,并将其设置为提供的字节范围。

TryFormat(Span<Char>, Int32, ReadOnlySpan<Char>, IFormatProvider)

尝试将当前日期/时间偏移实例的值格式化为提供的字符范围。

TryParse(ReadOnlySpan<Char>, DateTimeOffset)

尝试将日期和时间的指定范围表示形式转换为等效 DateTimeOffset 项,并返回一个值,该值指示转换是否成功。

TryParse(ReadOnlySpan<Char>, IFormatProvider, DateTimeOffset)

尝试将字符范围分析为值。

TryParse(ReadOnlySpan<Char>, IFormatProvider, DateTimeStyles, DateTimeOffset)

尝试将日期和时间的指定范围表示形式转换为等效 DateTimeOffset 项,并返回一个值,该值指示转换是否成功。

TryParse(String, DateTimeOffset)

尝试将日期和时间的指定字符串表示形式转换为等效 DateTimeOffset 项,并返回一个值,该值指示转换是否成功。

TryParse(String, IFormatProvider, DateTimeOffset)

尝试将字符串分析为值。

TryParse(String, IFormatProvider, DateTimeStyles, DateTimeOffset)

尝试将日期和时间的指定字符串表示形式转换为等效 DateTimeOffset 项,并返回一个值,该值指示转换是否成功。

TryParseExact(ReadOnlySpan<Char>, ReadOnlySpan<Char>, IFormatProvider, DateTimeStyles, DateTimeOffset)

使用指定的格式、区域性特定的格式信息和样式将字符范围中的日期和时间表示形式转换为等效 DateTimeOffset 的表示形式。 日期和时间表示形式的格式必须与指定的格式完全匹配。

TryParseExact(ReadOnlySpan<Char>, String[], IFormatProvider, DateTimeStyles, DateTimeOffset)

使用指定的格式、区域性特定的格式信息和样式将字符范围中的日期和时间表示形式转换为等效 DateTimeOffset 的表示形式。 日期和时间表示形式的格式必须与指定格式之一完全匹配。

TryParseExact(String, String, IFormatProvider, DateTimeStyles, DateTimeOffset)

使用指定的格式、区域性特定的格式信息和样式将日期和时间的指定字符串表示形式转换为等效 DateTimeOffset 的字符串表示形式。 字符串表示形式的格式必须与指定的格式完全匹配。

TryParseExact(String, String[], IFormatProvider, DateTimeStyles, DateTimeOffset)

使用指定的格式数组、区域性特定的格式信息和样式将日期和时间的指定字符串表示形式转换为等效 DateTimeOffset 的字符串表示形式。 字符串表示形式的格式必须与指定格式之一完全匹配。

运营商

名称 说明
Addition(DateTimeOffset, TimeSpan)

将指定的时间间隔添加到 DateTimeOffset 具有指定日期和时间的对象,并生成 DateTimeOffset 具有新日期和时间的对象。

Equality(DateTimeOffset, DateTimeOffset)

确定两个指定的 DateTimeOffset 对象是否表示相同的时间点。

GreaterThan(DateTimeOffset, DateTimeOffset)

确定一个指定的 DateTimeOffset 对象是否大于(或晚于)第二个指定 DateTimeOffset 对象。

GreaterThanOrEqual(DateTimeOffset, DateTimeOffset)

确定一个指定的 DateTimeOffset 对象是否大于或等于第二个指定的 DateTimeOffset 对象。

Implicit(DateTime to DateTimeOffset)

定义对象的隐式转换DateTimeDateTimeOffset

Inequality(DateTimeOffset, DateTimeOffset)

确定两个指定的 DateTimeOffset 对象是否引用不同的时间点。

LessThan(DateTimeOffset, DateTimeOffset)

确定一个指定的 DateTimeOffset 对象是否小于第二个指定 DateTimeOffset 对象。

LessThanOrEqual(DateTimeOffset, DateTimeOffset)

确定一个指定的 DateTimeOffset 对象是否小于第二个指定 DateTimeOffset 对象。

Subtraction(DateTimeOffset, DateTimeOffset)

从另一个对象中减去一个 DateTimeOffset 对象,并生成一个时间间隔。

Subtraction(DateTimeOffset, TimeSpan)

从指定的日期和时间中减去指定的时间间隔,并生成新的日期和时间。

显式接口实现

名称 说明
IComparable.CompareTo(Object)

将当前 DateTimeOffset 对象的值与同一类型的另一个对象进行比较。

IDeserializationCallback.OnDeserialization(Object)

在对象反序列化完成时运行。

ISerializable.GetObjectData(SerializationInfo, StreamingContext)

使用 SerializationInfo 序列化当前 DateTimeOffset 对象所需的数据填充对象。

适用于

另请参阅