Forecasts at sea
At sea the plan changes every day. cruiseplan forecast re-times the
schedule from where the ship is now, without editing the YAML. You need the
schedule NetCDF file written by cruiseplan schedule and the row you are
at, from cruiseplan list:
cruiseplan list MSM142_schedule.nc
cruiseplan forecast MSM142_schedule.nc --start-index 18 \
--start-time 2026-08-30T14:00-03:00 --format tex
--start-index is the row in cruiseplan list; --start-time is when
that row starts. See CLI Commands for every option.
Ship time and UTC
cruiseplan works in UTC. The printed plan (--format tex) can be in ship
time, so you can see what falls at breakfast, lunch and dinner. Give the start
time with the ship’s offset from UTC, as the ship clock shows it:
|
TeX table rows |
Time column |
|---|---|---|
|
ship time (UTC−3) |
|
|
ship time (UTC+13) |
|
|
UTC |
|
The first and last rows are the same moment: 14:00 ship time at UTC−3 is 17:00 UTC.
Writing the offset
Put the offset straight after the time, with no space:
14:00-03:00.West of Greenwich the offset is negative (Labrador Sea
-03:00, Newfoundland-02:30); east of it, positive (Ross Sea on New Zealand time+13:00).-03:00,-0300and-03are the same. Half-hour offsets need the minutes:-02:30.To check: ship time minus the offset is UTC. 14:00 at
-03:00is 14:00 + 3 h = 17:00 UTC.Zor+00:00means UTC; the table is then labelledUTC.A time without an offset is taken as UTC.
When the ship’s clock changes
Ship time changes during a cruise when the captain sets the clocks. The offset you give applies to the whole printed table, so after a clock change print the plan again with the new offset. A table that spans a clock change shows every row in the offset you gave.
What is in ship time
Only the TeX table. The text output, waypoints, KML and PNG stay in UTC, as does the NetCDF schedule. The text output’s header gives the start time in UTC.