---
type: Attested Computation
title: sun-times
identifier: astro/sun-times
description: Sunrise, sunset, and day length for a latitude, longitude, and UTC date, computed with ephem (no network). Times are printed in the given UTC offset so a caller can pass the local zone; the day-length delta against the day before says whether days are getting longer or shorter. Companion to net/ip-location.py, whose lat,lon this takes.
pack: astro
tags:
- world
runtime: fragletc
image: ofthemachine/python3@sha256:a015b4f9f0e7c1648f8fcd4164f6a296dd3c9189404f88f333a9764d08d13522
network: none
stdin: none
execution_class: hermetic
procedure_hash: sha256:2f1e6c670fe03aed6de089c4001a24c091797b2f3fbb4afb1a202e50c61bab38
parameters:
- name: lat
  type: string
  required: true
  description: Latitude in decimal degrees, e.g. 53.5457
- name: lon
  type: string
  required: true
  description: Longitude in decimal degrees, east positive, e.g. -113.5
- name: date
  type: string
  required: true
  description: UTC date as YYYY-MM-DD
- name: utc_offset
  type: string
  required: false
  default: '0'
  description: Hours to add when printing times, e.g. -6 for Edmonton in September
computation: https://tools.ofthemachine.com/astro/sun-times.py
executor:
  resource: https://github.com/ofthemachine/fraglet
  receipt:
  - schema
  - fragletc
  - procedure
  - procedure_hash
  - image
  - image_digest
  - network
  - stdin_mode
  - params
  - inputs
  - argv
  - env
  - memo_key
  - started
  - finished
  - exit_code
  - stdout
  - outputs
  format: fraglet-receipt/2 (fragletc --receipt <path>, or FRAGLETC_RECEIPT_DIR)
attester:
  resource: https://tools.ofthemachine.com/receipt/attest.py
  method: 'deterministic, no re-execution: procedure_hash equals sha256 of computation; memo_key recomputes from the receipt''s own fields; claimed params and any artifact hash match the receipt'
generated:
  by: process:tools/catalog/compile.py
  at: '2026-11-13T18:27:40Z'
---

# sun-times

Sunrise, sunset, and day length for a latitude, longitude, and UTC date, computed with ephem (no network). Times are printed in the given UTC offset so a caller can pass the local zone; the day-length delta against the day before says whether days are getting longer or shorter. Companion to net/ip-location.py, whose lat,lon this takes.

Use when the user asks when the sun rises or sets somewhere, how long the day is, or an almanac or weather box needs sun times for a place and date.

# Schema

## Parameters
- `lat` (string, required) — Latitude in decimal degrees, e.g. 53.5457
- `lon` (string, required) — Longitude in decimal degrees, east positive, e.g. -113.5
- `date` (string, required) — UTC date as YYYY-MM-DD
- `utc_offset` (string, optional, default `0`) — Hours to add when printing times, e.g. -6 for Edmonton in September

## Outputs
- stdout (the anonymous result)

# Execution

The computation is [`astro/sun-times.py`](https://tools.ofthemachine.com/astro/sun-times.py) (frontmatter `computation`; in `tools.tar.gz` the same file sits at `astro/sun-times.py` beside this bundle), run by `fragletc` in `ofthemachine/python3@sha256:a015b4f9f0e7c1648f8fcd4164f6a296dd3c9189404f88f333a9764d08d13522` with network `none`. Its identity is `procedure_hash` = sha256 of that file, shebang included — the same value every receipt records. Parameters are passed as `-p name=value`; `--receipt run.json` (or `FRAGLETC_RECEIPT_DIR`) writes the receipt, a `fraglet-receipt/2` JSON document with the fields listed under `executor.receipt`.

# Attestation

A run's receipt is attested with [`receipt/attest.py`](https://tools.ofthemachine.com/receipt/attest.py): the computation that ran is this script (`procedure_hash`), the receipt is internally consistent (`memo_key` recomputes from its own fields), the claimed parameters are the ones that ran, and an artifact claimed as an output hashes to what the receipt recorded. No re-execution: attestation is provenance fidelity, not reproduction.

Hermetic: no network, so `memo_key` also fully determines the outputs — a re-run with the same inputs must reproduce them, which makes results from this tool safely memoizable.

Skill: [SKILL.md](https://tools.ofthemachine.com/astro/SKILL.md)
