Class Date (2.2.0)

public sealed class Date : Protobuf.IMessage<Date>, Protobuf.IBufferMessage

Represents a whole or partial calendar date, e.g. a birthday. The time of day and time zone are either specified elsewhere or are not significant. The date is relative to the Proleptic Gregorian Calendar. This can represent:

  • A full date, with non-zero year, month and day values
  • A month and day value, with a zero year, e.g. an anniversary
  • A year on its own, with zero month and day values
  • A year and month value, with a zero day, e.g. 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
Int32

MonthFieldNumber

public const int MonthFieldNumber = 2

Field number for the "month" field.

Field Value
TypeDescription
Int32

YearFieldNumber

public const int YearFieldNumber = 1

Field number for the "year" field.

Field Value
TypeDescription
Int32

Properties

Day

public int Day { get; set; }

Day of month. Must be from 1 to 31 and valid for the year and month, or 0 if specifying a year by itself or a year and month where the day is not significant.

Property Value
TypeDescription
Int32

Descriptor

public static Protobuf.Reflection.MessageDescriptor Descriptor { get; }
Property Value
TypeDescription
Protobuf.Reflection.MessageDescriptor

Month

public int Month { get; set; }

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

Property Value
TypeDescription
Int32

Parser

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

Year

public int Year { get; set; }

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

Property Value
TypeDescription
Int32

Methods

CalculateSize()

public int CalculateSize()
Returns
TypeDescription
Int32

Clone()

public Date Clone()
Returns
TypeDescription
Date

Equals(Date)

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

Equals(Object)

public override bool Equals(object other)
Parameter
NameDescription
otherObject
Returns
TypeDescription
Boolean

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
Int32

MergeFrom(Protobuf.CodedInputStream)

public void MergeFrom(Protobuf.CodedInputStream input)
Parameter
NameDescription
inputProtobuf.CodedInputStream

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

WriteTo(Protobuf.CodedOutputStream)

public void WriteTo(Protobuf.CodedOutputStream output)
Parameter
NameDescription
outputProtobuf.CodedOutputStream