feat: Add parseAsISODate

packages/docs/content/docs/parsers/built-in.mdx

@@ -12,6 +12,7 @@ import {
   BooleanParserDemo,
   StringLiteralParserDemo,
   DateISOParserDemo,
+  DatetimeISOParserDemo,
   DateTimestampParserDemo,
   JsonParserDemo
 } from '@/content/docs/parsers/demos'
@@ -183,12 +184,22 @@ The query string value will be the **value** of the enum, not its name
 There are two parsers that give you a `Date` object, their difference is
 on how they encode the value into the query string.
 
-### ISO 8601
+### ISO 8601 Datetime
 
 ```ts
 import { parseAsIsoDateTime } from 'nuqs'
 ```
 
+<Suspense>
+  <DatetimeISOParserDemo/>
+</Suspense>
+
+### ISO 8601 Date
+
+```ts
+import { parseAsIsoDate } from 'nuqs'
+```
+
 <Suspense>
   <DateISOParserDemo/>
 </Suspense>

packages/docs/content/docs/parsers/demos.tsx

@@ -14,6 +14,7 @@ import {
   parseAsFloat,
   parseAsHex,
   parseAsInteger,
+  parseAsIsoDate,
   parseAsIsoDateTime,
   parseAsJson,
   parseAsStringLiteral,
@@ -290,10 +291,14 @@ export function DateParserDemo({
   )
 }
 
-export function DateISOParserDemo() {
+export function DatetimeISOParserDemo() {
   return <DateParserDemo queryKey="iso" parser={parseAsIsoDateTime} />
 }
 
+export function DateISOParserDemo() {
+  return <DateParserDemo queryKey="iso" parser={parseAsIsoDate} />
+}
+
 export function DateTimestampParserDemo() {
   return <DateParserDemo queryKey="ts" parser={parseAsTimestamp} />
 }

packages/nuqs/src/parsers.test.ts

@@ -5,6 +5,7 @@ import {
   parseAsHex,
   parseAsInteger,
   parseAsIsoDateTime,
+  parseAsIsoDate,
   parseAsString,
   parseAsTimestamp
 } from './parsers'
@@ -48,6 +49,16 @@ describe('parsers', () => {
       ref
     )
   })
+  test('parseAsIsoDate', () => {
+    expect(parseAsIsoDate.parse('')).toBeNull()
+    expect(parseAsIsoDate.parse('not-a-date')).toBeNull()
+    const moment = '2020-01-01'
+    const ref = new Date(moment)
+    expect(parseAsIsoDate.parse(moment)).toStrictEqual(ref)
+    expect(parseAsIsoDate.parse(moment.slice(0, 10))).toStrictEqual(ref)
+    expect(parseAsIsoDate.serialize(ref).length).toBe(10)
+    expect(parseAsIsoDate.serialize(ref).length).not.toContain('T')
+  })
   test('parseAsArrayOf', () => {
     const parser = parseAsArrayOf(parseAsString)
     expect(parser.serialize([])).toBe('')

packages/nuqs/src/parsers.ts

@@ -215,6 +215,22 @@ export const parseAsIsoDateTime = createParser({
   serialize: (v: Date) => v.toISOString()
 })
 
+/**
+ * Querystring encoded as an ISO-8601 string (UTC)
+ * without the time zone offset, and returned as
+ * a Date object.
+ */
+export const parseAsIsoDate = createParser({
+  parse: v => {
+    const date = new Date(v + 'T00:00:00.000Z')
+    if (Number.isNaN(date.valueOf())) {
+      return null
+    }
+    return date
+  },
+  serialize: (v: Date) => v.toISOString().slice(0, 10)
+})
+
 /**
  * String-based enums provide better type-safety for known sets of values.
  * You will need to pass the parseAsStringEnum function a list of your enum values