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
Name Description
other Date

Fields

DayFieldNumber

public const int DayFieldNumber = 3

Field number for the "day" field.

Field Value
Type Description
Int32

MonthFieldNumber

public const int MonthFieldNumber = 2

Field number for the "month" field.

Field Value
Type Description
Int32

YearFieldNumber

public const int YearFieldNumber = 1

Field number for the "year" field.

Field Value
Type Description
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
Type Description
Int32

Descriptor

public static Protobuf.Reflection.MessageDescriptor Descriptor { get; }
Property Value
Type Description
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
Type Description
Int32

Parser

public static Protobuf.MessageParser<Date> Parser { get; }
Property Value
Type Description
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
Type Description
Int32

Methods

CalculateSize()

public int CalculateSize()
Returns
Type Description
Int32

Clone()

public Date Clone()
Returns
Type Description
Date

Equals(Date)

public bool Equals(Date other)
Parameter
Name Description
other Date
Returns
Type Description
Boolean

Equals(Object)

public override bool Equals(object other)
Parameter
Name Description
other Object
Returns
Type Description
Boolean

FromDateTime(DateTime)

public static Date FromDateTime(DateTime dateTime)

Creates a Date instance from the Date part of DateTime.

Parameter
Name Description
dateTime DateTime

The DateTime value being converted.
Returns
Type Description
Date

The created Date.

FromDateTimeOffset(DateTimeOffset)

public static Date FromDateTimeOffset(DateTimeOffset dateTimeOffset)

Creates a Date instance from the Date part of DateTimeOffset.

Parameter
Name Description
dateTimeOffset DateTimeOffset

The DateTimeOffset value being converted.
Returns
Type Description
Date

The created Date.

GetHashCode()

public override int GetHashCode()
Returns
Type Description
Int32

MergeFrom(Protobuf.CodedInputStream)

public void MergeFrom(Protobuf.CodedInputStream input)
Parameter
Name Description
input Protobuf.CodedInputStream

MergeFrom(Date)

public void MergeFrom(Date other)
Parameter
Name Description
other Date

ToDateTime()

public DateTime ToDateTime()

Converts Date to DateTime.

Returns
Type Description
DateTime

The converted DateTime with time at midnight and Kind of Unspecified.
Exceptions
Type Description
InvalidOperationException

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

ToDateTimeOffset()

public DateTimeOffset ToDateTimeOffset()

Converts Date to DateTimeOffset.

Returns
Type Description
DateTimeOffset

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

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

ToString()

public override string ToString()
Returns
Type Description
String

WriteTo(Protobuf.CodedOutputStream)

public void WriteTo(Protobuf.CodedOutputStream output)
Parameter
Name Description
output Protobuf.CodedOutputStream