Card type

`sun_moon`

Sunrise, sunset, daylight and moon phase for a place and date.

Version 1 · schema sun_moon.v1.schema.json

Layouts

Every card type has full. Pick a layout with the element's layout attribute, render.layout, or a theme.

Fields

The fields of card.data. Values a source doesn't provide are null; new optional fields can appear within version 1.

Field	Type	Required	Notes
`location`	`object`	yes
`location.name`	`string`	yes
`location.timezone`	`string`	yes
`date`	`date`	yes	ISO 8601 calendar date.
`local_time`	`HH:MM`	yes	Time at the location when answered, so a renderer can place the sun.
`sun`	`object`	yes
`sun.rise`	`HH:MM \| null`	yes	null during polar night or day.
`sun.set`	`HH:MM \| null`	yes
`sun.day_length_min`	`integer`	yes
`moon`	`object`	yes
`moon.phase`	`enum`	yes	new · waxing_crescent · first_quarter · waxing_gibbous · full · waning_gibbous · last_quarter · waning_crescent
`moon.illumination_pct`	`number`	yes
`moon.next_full`	`date`	yes	ISO 8601 calendar date.
`moon.next_new`	`date`	yes	ISO 8601 calendar date.

Example

A recorded answer to “When is sunset today?”. Open it in the Answer Lab to see every layout and style.

Response

1{
2  "v": 2,
3  "id": "ans_fi4rj7dsu6yyym5p",
4  "matched": true,
5  "locale": "en",
6  "skill": "sun_moon",
7  "confidence": 0.9,
8  "text": "Today the sun sets at 6:02 PM.",
9  "speech": "Today the sun sets at 6:02 PM.",
10  "card": {
11    "type": "sun_moon",
12    "version": 1,
13    "data": {
14      "location": {
15        "name": "51.05° N, 13.74° E",
16        "timezone": "Europe/Berlin"
17      },
18      "date": "2026-10-21",
19      "local_time": "14:00",
20      "sun": {
21        "rise": "07:36",
22        "set": "18:02",
23        "day_length_min": 626
24      },
25      "moon": {
26        "phase": "waxing_gibbous",
27        "illumination_pct": 77,
28        "next_full": "2026-10-26",
29        "next_new": "2026-11-09"
30      }
31    }
32  },
33  "sources": [
34    {
35      "name": "Calculated from date and location",
36      "url": null,
37      "license": null
38    }
39  ],
40  "follow_ups": [],
41  "actions": [],
42  "usage": {
43    "billable": true
44  }
45}