tiempo

today

Get today's date as a PlainDate

Get today's date as a PlainDate in the specified timezone.

Signature

function today(timezone: Timezone): Temporal.PlainDate

type Timezone = 'UTC' | string;

Parameters

ParameterTypeDescription
timezoneTimezoneIANA timezone identifier (e.g., "America/New_York", "Europe/London") or "UTC"

Returns

A Temporal.PlainDate representing today's date.

Examples

Server-side: Get today in UTC

import { today } from '@gobrand/tiempo';

const todayUtc = today("UTC");

Server-side: Get today in user's timezone

import { today } from '@gobrand/tiempo';

// Get timezone from user preferences (stored in DB)
const todayUser = today(user.timezone);

Client-side: Get today in browser's timezone

import { today, browserTimezone } from '@gobrand/tiempo';

const todayLocal = today(browserTimezone());

Get today in a specific timezone

import { today } from '@gobrand/tiempo';

const todayInMadrid = today("Europe/Madrid");
const todayInTokyo = today("Asia/Tokyo");

On this page