The south function returns the (UTC) for True Solar Time (TST) 12:00 (noon) when the sun is at \alpha_S = 180° (south) according to DIN EN 17037. The default geographical settings are set in the file “LT_location.mat”. Change the settings to your preferred location and set the file to read-only in order to prevent your settings from being overwritten with the default values in future versions.
Usage:
[t,local] = south(day,coord,offset,mode)
Where:
| Parameter | Description |
t | Is the Coordinated Universal Time (UTC) at noon, when the sun is at \alpha_S = 180°. |
local | Returns the corresponding local time. |
day | Specifies the date in ‘dd.mm.yyyy’ format. |
coord | Specifies the geographic coordinates as 1 \times 2 vector. Default: [13.326 52.514] for Berlin, Germany. You can change the preference in the “LT_location.mat” file. |
offset | Defines the offset for local time adjustment to UTC, e.g. 2 for Central European Summer Time (CEST). Default is set to Berlin, Germany [13.326 52.514]. You can change the preference in the “LT_location.mat” file. |
Examples
Noon UTC in Berlin at the current date:
t = south
Note: this example was executed at 31.07.2021
Result:
t = 11:12:56
Noon local (summer) time in Berlin at the current date:
t = south([],[],2)
Note: this example was executed at 31.07.2021
Result:
t = 13:12:56
Noon UTC in Berlin at 21.05.2015:
t = south('21.05.2015')
Result:
t = 11:03:22
Noon UTC in Athens at 21.05.2015:
t = south('21.05.2015',[37.978 23.728])
Result:
t = 09:24:45
Noon local time in Athens at 21.05.2015:
t = south('21.05.2015',[37.978 23.728],3)
Result:
t = 12:24:45
Noon local time in Athens at 21.05.2015, minute exactly:
t = south('21.05.2015',[37.978 23.728],3,'min')
Result:
t = 12:25:00
Reference