now

Reads the local system clock and returns the current month point value. The month value is the local year and month; today's day is kept as a hidden anchor, so day precision renders today's date. It is equivalent to Month.from(new Date()).

import { Month } from "@teakit/month";

Month.now().toString(); // current local month, e.g. "2025-06"
Month.now().toString({ precision: "day" }); // today's date, e.g. "2025-06-12"

API Reference

Signature

Month.now(): MonthInstance;

Parameters

None.

Returns

Returns a new Month for the current local year and month, carrying today's local day as the hidden day anchor.

Agent Contract

FieldValue
Kindstatic factory
Canonical namenow
Readslocal system clock (year, month, day)
Mutates receiverNo
ReturnsMonthInstance
Related methodsfrom

Agent Notes

  • Month.now() is a boundary clock read; it does not perform Date month arithmetic.
  • For a default "current month", generate Month.now() rather than constructing a Date manually.
  • The current day is only a formatting anchor; it never affects month arithmetic, comparison, or difference.