2.17.0 (latest) 2.15.0 2.10.0 2.2.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](https://learn.microsoft.com/dotnet/api/system.object) \> Date

## Implements

[IMessage](https://cloud.google.com/dotnet/docs/reference/Google.Protobuf/latest/Google.Protobuf.IMessage-1.html)[Date](https://docs.cloud.google.com/dotnet/docs/reference/Google.Api.CommonProtos/latest/Google.Type.Date.md.txt), [IEquatable](https://learn.microsoft.com/dotnet/api/system.iequatable-1)[Date](https://docs.cloud.google.com/dotnet/docs/reference/Google.Api.CommonProtos/latest/Google.Type.Date.md.txt), [IDeepCloneable](https://cloud.google.com/dotnet/docs/reference/Google.Protobuf/latest/Google.Protobuf.IDeepCloneable-1.html)[Date](https://docs.cloud.google.com/dotnet/docs/reference/Google.Api.CommonProtos/latest/Google.Type.Date.md.txt), [IBufferMessage](https://cloud.google.com/dotnet/docs/reference/Google.Protobuf/latest/Google.Protobuf.IBufferMessage.html), [IMessage](https://cloud.google.com/dotnet/docs/reference/Google.Protobuf/latest/Google.Protobuf.IMessage.html)

## Inherited Members

[object.Equals(object, object)](https://learn.microsoft.com/dotnet/api/system.object.equals#system-object-equals(system-object-system-object)) [object.GetType()](https://learn.microsoft.com/dotnet/api/system.object.gettype) [object.ReferenceEquals(object, object)](https://learn.microsoft.com/dotnet/api/system.object.referenceequals)

## Namespace

[Google.Type](https://docs.cloud.google.com/dotnet/docs/reference/Google.Api.CommonProtos/latest/Google.Type.md.txt)

## 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** |
| `int` |   |

### MonthFieldNumber

    public const int MonthFieldNumber = 2

Field number for the "month" field.

| **Field Value** ||
|---|---|
| **Type** | **Description** |
| `int` |   |

### YearFieldNumber

    public const int YearFieldNumber = 1

Field number for the "year" field.

| **Field Value** ||
|---|---|
| **Type** | **Description** |
| `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** ||
|---|---|
| **Type** | **Description** |
| `int` |   |

### Descriptor

    public static MessageDescriptor Descriptor { get; }

| **Property Value** ||
|---|---|
| **Type** | **Description** |
| `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** ||
|---|---|
| **Type** | **Description** |
| `int` |   |

### Parser

    public static MessageParser<Date> Parser { get; }

| **Property Value** ||
|---|---|
| **Type** | **Description** |
| `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** ||
|---|---|
| **Type** | **Description** |
| `int` |   |

## Methods

### CalculateSize()

    public int CalculateSize()

| **Returns** ||
|---|---|
| **Type** | **Description** |
| `int` |   |

### Clone()

    public Date Clone()

| **Returns** ||
|---|---|
| **Type** | **Description** |
| `Date` |   |

### Equals(Date)

    public bool Equals(Date other)

| **Parameter** ||
|---|---|
| **Name** | **Description** |
| `other` | `Date` |

| **Returns** ||
|---|---|
| **Type** | **Description** |
| `bool` |   |

### Equals(object)

    public override bool Equals(object other)

| **Parameter** ||
|---|---|
| **Name** | **Description** |
| `other` | `object` |

| **Returns** ||
|---|---|
| **Type** | **Description** |
| `bool` |   |

**Overrides** [object.Equals(object)](https://learn.microsoft.com/dotnet/api/system.object.equals#system-object-equals(system-object))

### FromDateTime(DateTime)

    public static Date FromDateTime(DateTime dateTime)

Creates a [Date](https://docs.cloud.google.com/dotnet/docs/reference/Google.Api.CommonProtos/latest/Google.Type.Date.md.txt) instance from the [Date](https://learn.microsoft.com/dotnet/api/system.datetime.date) part of [DateTime](https://docs.cloud.google.com/dotnet/docs/reference/Google.Api.CommonProtos/latest/Google.Type.DateTime.md.txt).

| **Parameter** ||
|---|---|
| **Name** | **Description** |
| `dateTime` | `DateTime` The [DateTime](https://learn.microsoft.com/dotnet/api/system.datetime) value being converted. |

| **Returns** ||
|---|---|
| **Type** | **Description** |
| `Date` | The created [Date](https://docs.cloud.google.com/dotnet/docs/reference/Google.Api.CommonProtos/latest/Google.Type.Date.md.txt). |

### FromDateTimeOffset(DateTimeOffset)

    public static Date FromDateTimeOffset(DateTimeOffset dateTimeOffset)

Creates a [Date](https://docs.cloud.google.com/dotnet/docs/reference/Google.Api.CommonProtos/latest/Google.Type.Date.md.txt) instance from the [Date](https://learn.microsoft.com/dotnet/api/system.datetimeoffset.date) part of [DateTimeOffset](https://learn.microsoft.com/dotnet/api/system.datetimeoffset).

| **Parameter** ||
|---|---|
| **Name** | **Description** |
| `dateTimeOffset` | `DateTimeOffset` The [DateTimeOffset](https://learn.microsoft.com/dotnet/api/system.datetimeoffset) value being converted. |

| **Returns** ||
|---|---|
| **Type** | **Description** |
| `Date` | The created [Date](https://docs.cloud.google.com/dotnet/docs/reference/Google.Api.CommonProtos/latest/Google.Type.Date.md.txt). |

### GetHashCode()

    public override int GetHashCode()

| **Returns** ||
|---|---|
| **Type** | **Description** |
| `int` |   |

**Overrides** [object.GetHashCode()](https://learn.microsoft.com/dotnet/api/system.object.gethashcode)

### MergeFrom(CodedInputStream)

    public void MergeFrom(CodedInputStream input)

| **Parameter** ||
|---|---|
| **Name** | **Description** |
| `input` | `CodedInputStream` |

### MergeFrom(Date)

    public void MergeFrom(Date other)

| **Parameter** ||
|---|---|
| **Name** | **Description** |
| `other` | `Date` |

### ToDateTime()

    public DateTime ToDateTime()

Converts [Date](https://docs.cloud.google.com/dotnet/docs/reference/Google.Api.CommonProtos/latest/Google.Type.Date.md.txt) to [DateTime](https://learn.microsoft.com/dotnet/api/system.datetime).

| **Returns** ||
|---|---|
| **Type** | **Description** |
| `DateTime` | The converted [DateTime](https://docs.cloud.google.com/dotnet/docs/reference/Google.Api.CommonProtos/latest/Google.Type.DateTime.md.txt) with time at midnight and [Kind](https://learn.microsoft.com/dotnet/api/system.datetime.kind) of [Unspecified](https://learn.microsoft.com/dotnet/api/system.datetimekind#system-datetimekind-unspecified). |

| **Exceptions** ||
|---|---|
| **Type** | **Description** |
| `InvalidOperationException` | Thrown when [Year](https://docs.cloud.google.com/dotnet/docs/reference/Google.Api.CommonProtos/latest/Google.Type.Date.md.txt#Google_Type_Date_Year), [Month](https://docs.cloud.google.com/dotnet/docs/reference/Google.Api.CommonProtos/latest/Google.Type.Date.md.txt#Google_Type_Date_Month), and/or [Day](https://docs.cloud.google.com/dotnet/docs/reference/Google.Api.CommonProtos/latest/Google.Type.Date.md.txt#Google_Type_Date_Day) are not within the valid range. |

### ToDateTimeOffset()

    public DateTimeOffset ToDateTimeOffset()

Converts [Date](https://docs.cloud.google.com/dotnet/docs/reference/Google.Api.CommonProtos/latest/Google.Type.Date.md.txt) to [DateTimeOffset](https://learn.microsoft.com/dotnet/api/system.datetimeoffset).

| **Returns** ||
|---|---|
| **Type** | **Description** |
| `DateTimeOffset` | The converted [DateTimeOffset](https://learn.microsoft.com/dotnet/api/system.datetimeoffset) with time at midnight, [Kind](https://learn.microsoft.com/dotnet/api/system.datetime.kind) of [Unspecified](https://learn.microsoft.com/dotnet/api/system.datetimekind#system-datetimekind-unspecified), and an [Offset](https://learn.microsoft.com/dotnet/api/system.datetimeoffset.offset) of [Zero](https://learn.microsoft.com/dotnet/api/system.timespan.zero). |

| **Exceptions** ||
|---|---|
| **Type** | **Description** |
| `InvalidOperationException` | Thrown when [Year](https://docs.cloud.google.com/dotnet/docs/reference/Google.Api.CommonProtos/latest/Google.Type.Date.md.txt#Google_Type_Date_Year), [Month](https://docs.cloud.google.com/dotnet/docs/reference/Google.Api.CommonProtos/latest/Google.Type.Date.md.txt#Google_Type_Date_Month), and/or [Day](https://docs.cloud.google.com/dotnet/docs/reference/Google.Api.CommonProtos/latest/Google.Type.Date.md.txt#Google_Type_Date_Day) are not within the valid range. |

### ToString()

    public override string ToString()

| **Returns** ||
|---|---|
| **Type** | **Description** |
| `string` |   |

**Overrides** [object.ToString()](https://learn.microsoft.com/dotnet/api/system.object.tostring)

### WriteTo(CodedOutputStream)

    public void WriteTo(CodedOutputStream output)

| **Parameter** ||
|---|---|
| **Name** | **Description** |
| `output` | `CodedOutputStream` |