discord-timestamp-kit 0.1.0 → 0.2.0

package/README.md

@@ -26,6 +26,8 @@ for (const f of DISCORD_FORMATS) {
 // D Long Date        <t:1798765200:D>
 // f Short Date/Time  <t:1798765200:f>
 // F Long Date/Time   <t:1798765200:F>
+// s Short Date + Time  <t:1798765200:s>
+// S Short Date + Long Time <t:1798765200:S>
 // R Relative Time    <t:1798765200:R>
 ```
 
@@ -61,6 +63,7 @@ import { decodeSnowflake } from 'discord-timestamp-kit';
 const s = decodeSnowflake('175928847299117063');
 // { unixMs: 1462015105796, unixSeconds: 1462015105, workerId: 1, processId: 0, increment: 7 }
 new Date(s!.unixMs).toISOString();   // '2016-04-30T11:18:25.796Z'
+decodeSnowflake('https://discord.com/channels/81384788765712384/81384788765712384/175928847299117063'); // same result: message links work too
 ```
 
 Message, user, channel and server IDs are all snowflakes. The bit math uses BigInt, so IDs above `Number.MAX_SAFE_INTEGER` decode exactly. Pass the ID as a string.
@@ -70,7 +73,7 @@ Message, user, channel and server IDs are all snowflakes. The bit math uses BigI
 ```ts
 import { renderDiscordPreview } from 'discord-timestamp-kit';
 
-renderDiscordPreview(1798765200, 'F');                 // e.g. 'Thursday, December 31, 2026 8:00 PM'
+renderDiscordPreview(1798765200, 'F');                 // e.g. 'Thursday, December 31, 2026 at 8:00 PM'
 renderDiscordPreview(1798765200, 'R', 1798758000);     // 'in 2 hours'
 ```
 
@@ -80,7 +83,7 @@ The preview uses Discord's en-US layout, in the runtime's local time zone. The `
 
 | Export | What it does |
 |---|---|
-| `DISCORD_FORMATS` | The 7 format codes (`t T d D f F R`) with label, description and example |
+| `DISCORD_FORMATS` | The 9 format codes (`t T d D f F s S R`, in Discord's documented order) with label, description and example |
 | `buildTimestampCode(unix, code)` | Returns `<t:unix:code>` |
 | `dateTimeToUnixInTz(date, time, timeZone?)` | Converts a wall-clock date and time in an IANA zone to Unix seconds, DST-safe |
 | `parseUnixInput(raw)` | Parses an integer string in seconds or milliseconds, or returns `null` |

package/dist/discordTimestamp.d.ts

@@ -1,4 +1,4 @@
-export type DiscordFormatCode = 't' | 'T' | 'd' | 'D' | 'f' | 'F' | 'R';
+export type DiscordFormatCode = 't' | 'T' | 'd' | 'D' | 'f' | 'F' | 's' | 'S' | 'R';
 export interface DiscordFormat {
     code: DiscordFormatCode;
     label: string;

package/dist/index.js

@@ -8,13 +8,25 @@ var DISCORD_FORMATS = [
     code: "f",
     label: "Short Date/Time",
     description: "Discord's default when you paste a timestamp",
-    example: "November 28, 2018 9:01 PM"
+    example: "November 28, 2018 at 9:01 PM"
   },
   {
     code: "F",
     label: "Long Date/Time",
     description: "Includes the day of the week",
-    example: "Wednesday, November 28, 2018 9:01 PM"
+    example: "Wednesday, November 28, 2018 at 9:01 PM"
+  },
+  {
+    code: "s",
+    label: "Short Date + Time",
+    description: "Numeric date with hours and minutes",
+    example: "11/28/2018, 9:01 PM"
+  },
+  {
+    code: "S",
+    label: "Short Date + Long Time",
+    description: "Numeric date with seconds",
+    example: "11/28/2018, 9:01:00 PM"
   },
   {
     code: "R",
@@ -37,7 +49,8 @@ function parseUnixInput(raw) {
 }
 var DISCORD_EPOCH_MS = 1420070400000n;
 function decodeSnowflake(raw) {
-  const trimmed = raw.trim();
+  const link = /^https?:\/\/(?:(?:ptb|canary)\.)?discord(?:app)?\.com\/channels\/(?:@me|\d+)\/\d+(?:\/(\d+))?\/?$/.exec(raw.trim());
+  const trimmed = link ? link[1] ?? raw.trim().split("/").filter(Boolean).pop() : raw.trim();
   if (!/^\d{1,20}$/.test(trimmed)) return null;
   let id;
   try {
@@ -75,6 +88,9 @@ var MONTH_NAMES = [
 function pad(n) {
   return n.toString().padStart(2, "0");
 }
+function shortDate(d) {
+  return `${pad(d.getMonth() + 1)}/${pad(d.getDate())}/${d.getFullYear()}`;
+}
 function formatTime(d, withSeconds) {
   let hours = d.getHours();
   const minutes = pad(d.getMinutes());
@@ -115,13 +131,17 @@ function renderDiscordPreview(unixSeconds, code, nowSeconds = Math.floor(Date.no
     case "T":
       return formatTime(d, true);
     case "d":
-      return `${pad(d.getMonth() + 1)}/${pad(d.getDate())}/${d.getFullYear()}`;
+      return shortDate(d);
     case "D":
       return `${MONTH_NAMES[d.getMonth()]} ${d.getDate()}, ${d.getFullYear()}`;
     case "f":
-      return `${MONTH_NAMES[d.getMonth()]} ${d.getDate()}, ${d.getFullYear()} ${formatTime(d, false)}`;
+      return `${MONTH_NAMES[d.getMonth()]} ${d.getDate()}, ${d.getFullYear()} at ${formatTime(d, false)}`;
     case "F":
-      return `${DAY_NAMES[d.getDay()]}, ${MONTH_NAMES[d.getMonth()]} ${d.getDate()}, ${d.getFullYear()} ${formatTime(d, false)}`;
+      return `${DAY_NAMES[d.getDay()]}, ${MONTH_NAMES[d.getMonth()]} ${d.getDate()}, ${d.getFullYear()} at ${formatTime(d, false)}`;
+    case "s":
+      return `${shortDate(d)}, ${formatTime(d, false)}`;
+    case "S":
+      return `${shortDate(d)}, ${formatTime(d, true)}`;
     case "R":
       return formatRelative(unixSeconds, nowSeconds);
     default:
@@ -172,6 +192,7 @@ function dateTimeToUnixInTz(dateValue, timeValue, timeZone) {
     let actualUtc = utcGuess - offset1;
     const offset2 = offsetAt(actualUtc);
     if (offset2 !== offset1) actualUtc = utcGuess - offset2;
+    if (offsetAt(actualUtc) !== offset2) actualUtc = utcGuess - Math.min(offset1, offset2);
     return Math.floor(actualUtc / 1e3);
   } catch {
     const date = new Date(y, m - 1, d, h, min, 0, 0);

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "discord-timestamp-kit",
-  "version": "0.1.0",
+  "version": "0.2.0",
   "description": "Make Discord <t:unix:F> timestamp codes, convert a local date and time in any IANA time zone to Unix (DST-safe), parse seconds or milliseconds, and decode Discord snowflake IDs. Zero dependencies.",
   "type": "module",
   "exports": {