solar-time
Version:
This library provides functions to calculate local solar time, also known as local apparent time, based on a given location and date.
12 lines (11 loc) • 655 B
TypeScript
import type { SunPositionResult } from "./types";
/**
* Calculate sun position using NOAA formulas (0.833° atmospheric refraction).
* Note: sunrise/sunset are null in polar regions (polar night/midnight sun).
*
* @param isoDateTime - ISO 8601 string with timezone (e.g., "2025-11-01T09:00:00+09:00")
* @param latitude - Latitude in degrees (-90 to 90, + = North, - = South)
* @param longitude - Longitude in degrees (-180 to 180, + = East, - = West)
* @returns Sun position with times as ISO 8601 strings preserving timezone
*/
export declare const getSunPosition: (isoDateTime: string, latitude: number, longitude: number) => SunPositionResult;