# useDate API

> Auto-generated API reference for `useDate` from @vuetify/v0 (Vuetify0).
> Source of truth: https://0.vuetifyjs.com/api/use-date

## Related

- https://0.vuetifyjs.com/composables/plugins/use-date
- https://0.vuetifyjs.com/composables/plugins/use-locale
- https://0.vuetifyjs.com/composables/foundation/create-plugin

## Functions

### createDate

Creates a new date context.

```ts
(options: DateOptions<Z>) => E
```

### createDateContext

Creates a new date context trinity.

```ts
(_options: DateContextOptions<Z>) => ContextTrinity<E>
```

### createDatePlugin

Creates a new date plugin.

```ts
(_options: DatePluginOptions<Z>) => import("/home/runner/work/0/0/packages/0/src/composables/createPlugin/index").Plugin
```

### useDate

Returns the current date context.

Requires `createDatePlugin` to be installed with an adapter.

```ts
(namespace?: string) => E
```

## Options

| Name | Type | Default | Required | Description |
|---|---|---|---|---|
| `adapter` | `DateAdapter<Z>` | — | yes | Date adapter instance. |
| `locale` | `string \| undefined` | — | no | Locale for formatting (defaults to useLocale's selected locale or 'en-US') |
| `locales` | `Record<string, string> \| undefined` | — | no | Short locale codes mapped to full Intl locale strings (e.g., { en: 'en-US' }) |
| `firstDayOfWeek` | `number \| undefined` | — | no | First day of week override. 0=Sun, 1=Mon, ... 6=Sat. Derived from locale if not set. |

## Properties

| Name | Type | Description |
|---|---|---|
| `adapter` | `DateAdapter<Z>` | The date adapter instance |
| `locale` | `ComputedRef<string \| undefined>` | Current locale (reactive, synced with useLocale if available) |
| `firstDayOfWeek` | `ComputedRef<number>` | First day of week, derived from locale or explicit override |