@gobrand/tiempo 2.1.4 → 2.2.1

package/README.md

@@ -173,6 +173,49 @@ format(instant, "yyyy-MM-dd HH:mm", { timeZone: "Asia/Tokyo" }); // "2025-01-21
 
 ### Start/End Utilities
 
+#### `today(timezone?)`
+
+Get today's date in the system's local timezone or a specified timezone.
+
+**Parameters:**
+- `timezone` (string, optional): An IANA timezone identifier (e.g., `"America/New_York"`, `"Europe/Madrid"`) or `"UTC"`. If not provided, uses the system's local timezone.
+
+**Returns:** `Temporal.PlainDate` - A Temporal.PlainDate representing today's date
+
+**Example:**
+```typescript
+import { today } from '@gobrand/tiempo';
+
+const date = today(); // 2025-01-20
+date.year;      // 2025
+date.month;     // 1
+date.day;       // 20
+
+// Get today in a specific timezone
+const dateInTokyo = today("Asia/Tokyo"); // 2025-01-21 (next day due to timezone)
+```
+
+#### `now(timezone?)`
+
+Get the current date and time in the system's local timezone or a specified timezone.
+
+**Parameters:**
+- `timezone` (string, optional): An IANA timezone identifier (e.g., `"America/New_York"`, `"Europe/Madrid"`) or `"UTC"`. If not provided, uses the system's local timezone.
+
+**Returns:** `Temporal.ZonedDateTime` - A Temporal.ZonedDateTime representing the current date and time
+
+**Example:**
+```typescript
+import { now } from '@gobrand/tiempo';
+
+const current = now(); // 2025-01-20T15:30:45.123-05:00[America/New_York]
+current.hour;   // 15
+current.minute; // 30
+
+// Get current time in a specific timezone
+const currentInTokyo = now("Asia/Tokyo"); // 2025-01-21T05:30:45.123+09:00[Asia/Tokyo]
+```
+
 #### `startOfDay(input)` / `endOfDay(input)`
 
 Get the start or end of the day for a given datetime.

package/dist/chunk-3YGPHHB6.js

@@ -0,0 +1,13 @@
+// src/now.ts
+import { Temporal } from "@js-temporal/polyfill";
+function now(timezone) {
+  if (timezone) {
+    return Temporal.Now.zonedDateTimeISO(timezone);
+  }
+  return Temporal.Now.zonedDateTimeISO();
+}
+
+export {
+  now
+};
+//# sourceMappingURL=chunk-3YGPHHB6.js.map

package/dist/chunk-3YGPHHB6.js.map

@@ -0,0 +1 @@
+{"version":3,"sources":["../src/now.ts"],"sourcesContent":["import { Temporal } from '@js-temporal/polyfill';\n\n/**\n * Get the current date and time in the system's local timezone or a specified timezone.\n *\n * @param timezone - Optional IANA timezone identifier (e.g., \"America/Asuncion\", \"Europe/Madrid\") or \"UTC\"\n * @returns A Temporal.ZonedDateTime representing the current date and time\n *\n * @example\n * ```typescript\n * // Get now in local timezone\n * const current = now();\n *\n * // Get now in Madrid\n * const nowInMadrid = now(\"Europe/Madrid\");\n *\n * // Get now in UTC\n * const nowUtc = now(\"UTC\");\n * ```\n */\nexport function now(timezone?: 'UTC' | string): Temporal.ZonedDateTime {\n  if (timezone) {\n    return Temporal.Now.zonedDateTimeISO(timezone);\n  }\n  return Temporal.Now.zonedDateTimeISO();\n}\n"],"mappings":";AAAA,SAAS,gBAAgB;AAoBlB,SAAS,IAAI,UAAmD;AACrE,MAAI,UAAU;AACZ,WAAO,SAAS,IAAI,iBAAiB,QAAQ;AAAA,EAC/C;AACA,SAAO,SAAS,IAAI,iBAAiB;AACvC;","names":[]}

package/dist/chunk-67QHALIG.js

@@ -0,0 +1,13 @@
+// src/today.ts
+import { Temporal } from "@js-temporal/polyfill";
+function today(timezone) {
+  if (timezone) {
+    return Temporal.Now.zonedDateTimeISO(timezone).toPlainDate();
+  }
+  return Temporal.Now.plainDateISO();
+}
+
+export {
+  today
+};
+//# sourceMappingURL=chunk-67QHALIG.js.map

package/dist/chunk-67QHALIG.js.map

@@ -0,0 +1 @@
+{"version":3,"sources":["../src/today.ts"],"sourcesContent":["import { Temporal } from '@js-temporal/polyfill';\n\n/**\n * Get today's date in the system's local timezone or a specified timezone.\n *\n * @param timezone - Optional IANA timezone identifier (e.g., \"America/Asuncion\", \"Europe/Madrid\") or \"UTC\"\n * @returns A Temporal.PlainDate representing today's date\n *\n * @example\n * ```typescript\n * // Get today in local timezone\n * const date = today();\n *\n * // Get today in Madrid\n * const todayInMadrid = today(\"Europe/Madrid\");\n *\n * // Get today in UTC\n * const todayUtc = today(\"UTC\");\n * ```\n */\nexport function today(timezone?: \"UTC\" | string): Temporal.PlainDate {\n  if (timezone) {\n    return Temporal.Now.zonedDateTimeISO(timezone).toPlainDate();\n  }\n  return Temporal.Now.plainDateISO();\n}\n"],"mappings":";AAAA,SAAS,gBAAgB;AAoBlB,SAAS,MAAM,UAA+C;AACnE,MAAI,UAAU;AACZ,WAAO,SAAS,IAAI,iBAAiB,QAAQ,EAAE,YAAY;AAAA,EAC7D;AACA,SAAO,SAAS,IAAI,aAAa;AACnC;","names":[]}

package/dist/index.d.ts

@@ -2,6 +2,8 @@ export { toZonedTime } from './toZonedTime';
 export { toUtc } from './toUtc';
 export { toUtcString } from './toUtcString';
 export { format, type FormatOptions } from './format';
+export { today } from './today';
+export { now } from './now';
 export { startOfDay } from './startOfDay';
 export { endOfDay } from './endOfDay';
 export { startOfWeek } from './startOfWeek';

package/dist/index.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,WAAW,EAAE,MAAM,eAAe,CAAC;AAC5C,OAAO,EAAE,KAAK,EAAE,MAAM,SAAS,CAAC;AAChC,OAAO,EAAE,WAAW,EAAE,MAAM,eAAe,CAAC;AAC5C,OAAO,EAAE,MAAM,EAAE,KAAK,aAAa,EAAE,MAAM,UAAU,CAAC;AACtD,OAAO,EAAE,UAAU,EAAE,MAAM,cAAc,CAAC;AAC1C,OAAO,EAAE,QAAQ,EAAE,MAAM,YAAY,CAAC;AACtC,OAAO,EAAE,WAAW,EAAE,MAAM,eAAe,CAAC;AAC5C,OAAO,EAAE,SAAS,EAAE,MAAM,aAAa,CAAC;AACxC,OAAO,EAAE,YAAY,EAAE,MAAM,gBAAgB,CAAC;AAC9C,OAAO,EAAE,UAAU,EAAE,MAAM,cAAc,CAAC;AAC1C,OAAO,EAAE,WAAW,EAAE,MAAM,eAAe,CAAC;AAC5C,OAAO,EAAE,SAAS,EAAE,MAAM,aAAa,CAAC;AACxC,OAAO,EAAE,QAAQ,EAAE,MAAM,YAAY,CAAC;AACtC,OAAO,EAAE,OAAO,EAAE,MAAM,WAAW,CAAC;AACpC,OAAO,EAAE,SAAS,EAAE,MAAM,aAAa,CAAC"}
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,WAAW,EAAE,MAAM,eAAe,CAAC;AAC5C,OAAO,EAAE,KAAK,EAAE,MAAM,SAAS,CAAC;AAChC,OAAO,EAAE,WAAW,EAAE,MAAM,eAAe,CAAC;AAC5C,OAAO,EAAE,MAAM,EAAE,KAAK,aAAa,EAAE,MAAM,UAAU,CAAC;AACtD,OAAO,EAAE,KAAK,EAAE,MAAM,SAAS,CAAC;AAChC,OAAO,EAAE,GAAG,EAAE,MAAM,OAAO,CAAC;AAC5B,OAAO,EAAE,UAAU,EAAE,MAAM,cAAc,CAAC;AAC1C,OAAO,EAAE,QAAQ,EAAE,MAAM,YAAY,CAAC;AACtC,OAAO,EAAE,WAAW,EAAE,MAAM,eAAe,CAAC;AAC5C,OAAO,EAAE,SAAS,EAAE,MAAM,aAAa,CAAC;AACxC,OAAO,EAAE,YAAY,EAAE,MAAM,gBAAgB,CAAC;AAC9C,OAAO,EAAE,UAAU,EAAE,MAAM,cAAc,CAAC;AAC1C,OAAO,EAAE,WAAW,EAAE,MAAM,eAAe,CAAC;AAC5C,OAAO,EAAE,SAAS,EAAE,MAAM,aAAa,CAAC;AACxC,OAAO,EAAE,QAAQ,EAAE,MAAM,YAAY,CAAC;AACtC,OAAO,EAAE,OAAO,EAAE,MAAM,WAAW,CAAC;AACpC,OAAO,EAAE,SAAS,EAAE,MAAM,aAAa,CAAC"}

package/dist/index.js

@@ -1,9 +1,18 @@
+import {
+  toUtcString
+} from "./chunk-DMKGJY4N.js";
 import {
   toZonedTime
 } from "./chunk-KD5GEHUA.js";
+import {
+  today
+} from "./chunk-67QHALIG.js";
 import {
   isSameDay
 } from "./chunk-RW3C2677.js";
+import {
+  now
+} from "./chunk-3YGPHHB6.js";
 import {
   startOfDay
 } from "./chunk-TW5EV3DH.js";
@@ -19,9 +28,6 @@ import {
 import {
   toUtc
 } from "./chunk-GPAFAHKJ.js";
-import {
-  toUtcString
-} from "./chunk-DMKGJY4N.js";
 import {
   endOfDay
 } from "./chunk-CUMB4776.js";
@@ -54,12 +60,14 @@ export {
   isAfter,
   isBefore,
   isSameDay,
+  now,
   startOfDay,
   startOfMonth,
   startOfWeek,
   startOfYear,
   toUtc,
   toUtcString,
-  toZonedTime
+  toZonedTime,
+  today
 };
 //# sourceMappingURL=index.js.map

package/dist/now.d.ts

@@ -0,0 +1,21 @@
+import { Temporal } from '@js-temporal/polyfill';
+/**
+ * Get the current date and time in the system's local timezone or a specified timezone.
+ *
+ * @param timezone - Optional IANA timezone identifier (e.g., "America/Asuncion", "Europe/Madrid") or "UTC"
+ * @returns A Temporal.ZonedDateTime representing the current date and time
+ *
+ * @example
+ * ```typescript
+ * // Get now in local timezone
+ * const current = now();
+ *
+ * // Get now in Madrid
+ * const nowInMadrid = now("Europe/Madrid");
+ *
+ * // Get now in UTC
+ * const nowUtc = now("UTC");
+ * ```
+ */
+export declare function now(timezone?: 'UTC' | string): Temporal.ZonedDateTime;
+//# sourceMappingURL=now.d.ts.map

package/dist/now.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"now.d.ts","sourceRoot":"","sources":["../src/now.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,QAAQ,EAAE,MAAM,uBAAuB,CAAC;AAEjD;;;;;;;;;;;;;;;;;GAiBG;AACH,wBAAgB,GAAG,CAAC,QAAQ,CAAC,EAAE,KAAK,GAAG,MAAM,GAAG,QAAQ,CAAC,aAAa,CAKrE"}

package/dist/now.js

@@ -0,0 +1,7 @@
+import {
+  now
+} from "./chunk-3YGPHHB6.js";
+export {
+  now
+};
+//# sourceMappingURL=now.js.map

package/dist/now.js.map

@@ -0,0 +1 @@
+{"version":3,"sources":[],"sourcesContent":[],"mappings":"","names":[]}

package/dist/now.test.d.ts

@@ -0,0 +1,2 @@
+export {};
+//# sourceMappingURL=now.test.d.ts.map

package/dist/now.test.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"now.test.d.ts","sourceRoot":"","sources":["../src/now.test.ts"],"names":[],"mappings":""}

package/dist/today.d.ts

@@ -0,0 +1,21 @@
+import { Temporal } from '@js-temporal/polyfill';
+/**
+ * Get today's date in the system's local timezone or a specified timezone.
+ *
+ * @param timezone - Optional IANA timezone identifier (e.g., "America/Asuncion", "Europe/Madrid") or "UTC"
+ * @returns A Temporal.PlainDate representing today's date
+ *
+ * @example
+ * ```typescript
+ * // Get today in local timezone
+ * const date = today();
+ *
+ * // Get today in Madrid
+ * const todayInMadrid = today("Europe/Madrid");
+ *
+ * // Get today in UTC
+ * const todayUtc = today("UTC");
+ * ```
+ */
+export declare function today(timezone?: "UTC" | string): Temporal.PlainDate;
+//# sourceMappingURL=today.d.ts.map

package/dist/today.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"today.d.ts","sourceRoot":"","sources":["../src/today.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,QAAQ,EAAE,MAAM,uBAAuB,CAAC;AAEjD;;;;;;;;;;;;;;;;;GAiBG;AACH,wBAAgB,KAAK,CAAC,QAAQ,CAAC,EAAE,KAAK,GAAG,MAAM,GAAG,QAAQ,CAAC,SAAS,CAKnE"}

package/dist/today.js

@@ -0,0 +1,7 @@
+import {
+  today
+} from "./chunk-67QHALIG.js";
+export {
+  today
+};
+//# sourceMappingURL=today.js.map

package/dist/today.js.map

@@ -0,0 +1 @@
+{"version":3,"sources":[],"sourcesContent":[],"mappings":"","names":[]}

package/dist/today.test.d.ts

@@ -0,0 +1,2 @@
+export {};
+//# sourceMappingURL=today.test.d.ts.map

package/dist/today.test.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"today.test.d.ts","sourceRoot":"","sources":["../src/today.test.ts"],"names":[],"mappings":""}

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@gobrand/tiempo",
-  "version": "2.1.4",
+  "version": "2.2.1",
   "description": "Lightweight utility functions for converting between UTC and timezone-aware datetimes using the Temporal API",
   "private": false,
   "publishConfig": {