Webtags/Parameters: Difference between revisions

From Cumulus Wiki
Jump to navigationJump to search

Webtags/Parameters (view source)

Revision as of 07:57, 3 October 2022

1,270 bytes removed ,  07:57, 3 October 2022
m
→‎Which tag names take date/time output formatting modifiers
Line 153: Line 153:
==== Which tag names take date/time output formatting modifiers ====
==== Which tag names take date/time output formatting modifiers ====


When counted some time ago MX already offered a thousand different tag names.  
It is not practical to indicate which time/date modifiers are accepted on a tag by tag basis.  It would involve a lot of repetition.  Instead, the following table, explains much more simply, which web tags will accept time and/or date output modifiers.


There are a few time-related tag names labelled as being fixed format, that means any time/date output modifiers you might try would be ignored.
There are some tag names (e.g. moon rise) that relate to an event that does not happen each Earth day, so those tags have to be able to report "--:--".  Equally, many of the tag names that describe extreme records for this month/year/all-time are not defined until the respective period reaches its second day, so again those tags may output hyphens. When hyphens are output, output modifiers have no effect.


Some tag names, although it can be hard to tell which, report durations. You can use time modifiers to change how these are reported. Examples include '''<#daylength format=H:mm:ss>''' which reports day length  and '''<#MonthDailyRainHD format=H:mm>''' which reports how much of a day it was raining.
Time modifiers can also be used to change the way that clock times are reported, you might only want the hour, or you might (if resolution is available) want to also see seconds.  The [[webtags]] page has columns headed "Time" to clearly identify all tag names that report clock times.
There are some tag names (e.g. moon rise) that relate to an event that does not happen each Earth day, so those tags have to be able to report "--:--", and you cannot modify their output.  Equally, many of the tag names that describe extreme records for this month/year/all-time are not defined until the respective period reaches its second day, so again those tags may output hyphens and so any modification parameters will be ignored.  For example, highest temperature range in month/year has been coded in Cumulus to report "--" for value, and "--:--" for time, on the first day of that period (because there is only a partial day to consider you might not yet have experienced a true maximum and a true minimum), so modifying the time output can only be done on subsequent days.
It is not practical to indicate which time/date modifiers are accepted on a tag by tag basis.  It would involve a lot of repetition.  Instead, the following table, explains much more simply, which web tags will accept time and/or date output modifiers:
{| class="wikitable" border="1"
{| class="wikitable" border="1"
|-
|-
!style="width:100px" | Cross-reference to table on web tag names page
!style="width:100px" | Cross-reference to table on [[Full_list_of_Webtags|List of Webtags]] page
!style="width:300px" | Tag names that accept only time output modifiers
!style="width:300px" | Tag names that accept only time output modifiers
!style="width:300px" | Tag names that accept only date output modifiers
!style="width:300px" | Tag names that accept only date output modifiers
!style="width:300px" | Tag names that accept both time and date output modifiers
!style="width:300px" | Tag names that accept both time and date output modifiers
|-
|-
! scope="row"| [[Full_list_of_Webtags#Date_.26_Time|Date & Time]] and [[Full_list_of_Webtags#Day.2FNight.2FSun.2FMoon|Sun & Moon]]
| <#timehhmmss>, <#minute>, <#hour>, <#sunrise>, <#sunset>, <#dawn>, <#dusk>
| <#LatestErrorDate>, <#date>
| <#LastDataReadT>, <#time>, <#metdate>, <#metdateyesterday>, <#update>, <#LastDataReadT>
|-
|-
! scope="row"| Any tag names that don't report times nor dates
! scope="row"| [[Full_list_of_Webtags#Today|Today]], [[Full_list_of_Webtags#Yesterday|Yesterday]]
| None
| Each tag name in "Time" column of linked table has limited ability to modify output format
| None
| None
|-
! scope="row"| [[Webtags#No_Commas]]
| None
| None
| None
|-
! scope="row"| [[Webtags#Date_.26_Time]], [[Webtags#Day/Night/Sun/Moon]]
| Only <#timehhmmss>, <#minute>, <#hour>, <#sunrise>, <#sunset>, <#dawn>, <#dusk>
| Only <#LatestErrorDate>, <#date>  (but no others)
| Only <#LastDataReadT>, <#time>, <#metdate>, <#metdateyesterday>, <#update>, <#LastDataReadT>
|-
! scope="row"| [[Webtags#Today]], [[Webtags#Yesterday]]
| Each tag name in "Time" column of linked table has limited (see ~ below the table) ability to modify output format
| None
| None
| None
| None
Retrieved from "https://www.cumuluswiki.org/a/Special:MobileDiff/10847"

Navigation menu