Message HrzProtocol.CalendarDate

Defined in hrz/protocol/scene/view_settings.proto.

Date and time in a timezone, on the proleptic Gregorian calendar. The Sun is fixed relative to the Earth; moving the camera changes where it appears in the sky.

This is the only way to give the Sun an actual date, as opposed to a position within an idealised year. Leap years are accounted for, and the Sun stays within a hundredth of a degree of its real position between 1950 and 2050.

Fields

year: int32

month: int32

[1, 12]

day: int32

[1, 31]

time: float

Time in the timezone, hours, [0, 24). This is civil clock time, which is a mean solar time, so the Sun crosses the meridian of utc_offset at 12:00 give or take the equation of time. Leap seconds are ignored.

utc_offset: float

Offset from UTC, hours, [-12, 14]. Daylight saving time is the caller’s business: this is the offset that applies on that date, not the timezone’s standard offset. Examples:

• GMT: 0
• CET: 1
• CEST: 2
• IST: 5.5
• EST: -5