# useDateFormatter
> Provides a memoised Intl.DateTimeFormat instance for date formatting.

Provides a memoised `Intl.DateTimeFormat` instance for locale-aware date formatting. It caches formatter instances for performance and automatically respects the specified locale.

## Import

```js
import { useDateFormatter } from '@volue/wave-react';
```

## Example

```jsx
() => {
  const formatter = useDateFormatter('en-US', {
    year: 'numeric',
    month: 'long',
    day: 'numeric'
  });

  return <Text>{formatter.format(new Date())}</Text>;
};
```

---

## API reference

### Arguments

| Name      | Type                         | Default | Description                                                                                  | Required |
| --------- | ---------------------------- | ------- | -------------------------------------------------------------------------------------------- | -------- |
| `locale`  | `string`                     | `—`     | The locale for date formatting (e.g. "en-US"). When omitted, uses the user's default locale. |          |
| `options` | `Intl.DateTimeFormatOptions` | `—`     | Formatting options such as year, month, day, hour, etc.                                      |          |

### Returns

`Intl.DateTimeFormat` — A memoised formatter instance.