Class Date (2.10.0)

public sealed class Date : IMessage<Date>, IEquatable<Date>, IDeepCloneable<Date>, IBufferMessage, IMessage

Represents a whole or partial calendar date, such as a birthday. The time of day and time zone are either specified elsewhere or are insignificant. The date is relative to the Gregorian Calendar. This can represent one of the following:

  • A full date, with non-zero year, month, and day values
  • A month and day value, with a zero year, such as an anniversary
  • A year on its own, with zero month and day values
  • A year and month value, with a zero day, such as a credit card expiration date

Related types are [google.type.TimeOfDay][google.type.TimeOfDay] and google.protobuf.Timestamp.

Inheritance

object > Date

Namespace

Google.Type

Assembly

Google.Api.CommonProtos.dll

Constructors

Date()

public Date()

Date(Date)

public Date(Date other)
Parameter
NameDescription
otherDate

Fields

DayFieldNumber

public const int DayFieldNumber = 3

Field number for the "day" field.

Field Value
TypeDescription
int

MonthFieldNumber

public const int MonthFieldNumber = 2

Field number for the "month" field.

Field Value
TypeDescription
int

YearFieldNumber

public const int YearFieldNumber = 1

Field number for the "year" field.

Field Value
TypeDescription
int

Properties

Day

public int Day { get; set; }

Day of a month. Must be from 1 to 31 and valid for the year and month, or 0 to specify a year by itself or a year and month where the day isn't significant.

Property Value
TypeDescription
int

Descriptor

public static MessageDescriptor Descriptor { get; }
Property Value
TypeDescription
MessageDescriptor

Month

public int Month { get; set; }

Month of a year. Must be from 1 to 12, or 0 to specify a year without a month and day.

Property Value
TypeDescription
int

Parser

public static MessageParser<Date> Parser { get; }
Property Value
TypeDescription
MessageParserDate

Year

public int Year { get; set; }

Year of the date. Must be from 1 to 9999, or 0 to specify a date without a year.

Property Value
TypeDescription
int

Methods

CalculateSize()

public int CalculateSize()
Returns
TypeDescription
int

Clone()

public Date Clone()
Returns
TypeDescription
Date

Equals(Date)

public bool Equals(Date other)
Parameter
NameDescription
otherDate
Returns
TypeDescription
bool

Equals(object)

public override bool Equals(object other)
Parameter
NameDescription
otherobject
Returns
TypeDescription
bool
Overrides

FromDateTime(DateTime)

public static Date FromDateTime(DateTime dateTime)

Creates a Date instance from the Date part of DateTime.

Parameter
NameDescription
dateTimeDateTime

The DateTime value being converted.

Returns
TypeDescription
Date

The created Date.

FromDateTimeOffset(DateTimeOffset)

public static Date FromDateTimeOffset(DateTimeOffset dateTimeOffset)

Creates a Date instance from the Date part of DateTimeOffset.

Parameter
NameDescription
dateTimeOffsetDateTimeOffset

The DateTimeOffset value being converted.

Returns
TypeDescription
Date

The created Date.

GetHashCode()

public override int GetHashCode()
Returns
TypeDescription
int
Overrides

MergeFrom(CodedInputStream)

public void MergeFrom(CodedInputStream input)
Parameter
NameDescription
inputCodedInputStream

MergeFrom(Date)

public void MergeFrom(Date other)
Parameter
NameDescription
otherDate

ToDateTime()

public DateTime ToDateTime()

Converts Date to DateTime.

Returns
TypeDescription
DateTime

The converted DateTime with time at midnight and Kind of Unspecified.

Exceptions
TypeDescription
InvalidOperationException

Thrown when Year, Month, and/or Day are not within the valid range.

ToDateTimeOffset()

public DateTimeOffset ToDateTimeOffset()

Converts Date to DateTimeOffset.

Returns
TypeDescription
DateTimeOffset

The converted DateTimeOffset with time at midnight, Kind of Unspecified, and an Offset of Zero.

Exceptions
TypeDescription
InvalidOperationException

Thrown when Year, Month, and/or Day are not within the valid range.

ToString()

public override string ToString()
Returns
TypeDescription
string
Overrides

WriteTo(CodedOutputStream)

public void WriteTo(CodedOutputStream output)
Parameter
NameDescription
outputCodedOutputStream