5,838
edits
Webtags/Parameters (preserving history): Difference between revisions
From Cumulus Wiki
Jump to navigationJump to search
Webtags/Parameters (preserving history) (view source)
Revision as of 22:42, 13 December 2021
, 22:42, 13 December 2021→Which tag names take date/time output formatting modifiers: add 'StormRainStart'
m (Minor resequencing of page) |
m (→Which tag names take date/time output formatting modifiers: add 'StormRainStart') |
||
| (3 intermediate revisions by the same user not shown) | |||
| Line 74: | Line 74: | ||
! scope="row"| Tag names listed at [[Webtags#Table of Recent History tag names available|'''Table of Recent History tag names available''']] (see [[Recent history]] page for explanation) | ! scope="row"| Tag names listed at [[Webtags#Table of Recent History tag names available|'''Table of Recent History tag names available''']] (see [[Recent history]] page for explanation) | ||
| One value for each minute in last 7 days | | One value for each minute in last 7 days | ||
| | | '''d''' specifies number of days ago, | ||
'''h''' specifies number of hours ago, | |||
and '''m''' specifies number of minutes ago. | |||
* You can use any combination of the three parameters. | * You can use any combination of the three parameters. | ||
* The same d, h, and m, parameters are used by Cumulus 1 and MX. | * The same d, h, and m, parameters are used by Cumulus 1 and MX. | ||
| Line 80: | Line 84: | ||
| Examples for outside temperature: | | Examples for outside temperature: | ||
* <#RecentOutsideTemp m=1> will give the temperature one minute ago, <#RecentOutsideTemp h=1> will give the temperature one hour ago (as will <#RecentOutsideTemp m=60>). | * <#RecentOutsideTemp m=1> will give the temperature one minute ago, <#RecentOutsideTemp h=1> will give the temperature one hour ago (as will <#RecentOutsideTemp m=60>). | ||
* <#RecentOutsideTemp d=1> will give the temperature one day ago | * <#RecentOutsideTemp d=1> will give the temperature one day ago. | ||
* <#RecentOutsideTemp d=1 h=1 m=1> will give the temperature one day, one hour and one minute ago. | * <#RecentOutsideTemp d=1 h=1 m=1> will give the temperature one day, one hour and one minute ago. | ||
|All values supplied for parameters must be whole numbers. | |All values supplied for parameters must be whole numbers. | ||
* If you don't supply any parameters, the result is undefined for Cumulus 1, and an illegal web tag for MX. | * If you don't supply any parameters, the result is undefined for Cumulus 1, and an illegal web tag for MX. | ||
* '''Beware: If you use <code><#RecentRainToday d=2></code> remember that rainfall can accumulate during a day, so "d=2" returns an estimate of the rain between rollover 2 days ago and the same time as now 48 hours ago, it does not return the total rainfall 2 days ago!''' | * '''Beware: If you use <code><#RecentRainToday d=2></code> remember that rainfall can accumulate during a day, so "d=2" returns an estimate of the rain between rollover 2 days ago and the same time as now 48 hours ago, it does not return the total rainfall 2 days ago! | ||
* ''''''Please note:''' Some Cumulus users say that using <#RecentOutsideTemp d=1 m=1> is more reliable at getting the temperature at a similar time the day before, the extra minute apparently gives better results when you might not be using Cumulus all the time, or your weather station might have some drift on when it supplies readings. See which works best for you. | |||
|- | |- | ||
! scope="row"| [[Webtags#Monthly_All_Time_Records|'''monthly all-time extreme records''']] | ! scope="row"| [[Webtags#Monthly_All_Time_Records|'''monthly all-time extreme records''']] | ||
| These exist for all occurrences of the current month, and for all occurrences of each month | | These exist for all occurrences of the current month, and for all occurrences of each month | ||
| '''mon=N''' where N is the index of the month of the year that you want the value for (1 =January, and so on, to 12 =December) | | '''mon=N''' | ||
where N is the index of the month of the year that you want the value for (1 =January, and so on, to 12 =December) | |||
| Cumulus 1.9.3 beta build 1033 (remain available in MX) | | Cumulus 1.9.3 beta build 1033 (remain available in MX) | ||
| | | <#ByMonthDewPointH mon=3> is highest monthly dew point for any March and <#ByMonthDewPointHT mon=3> is the related time and date. | ||
<#ByMonthTempH mon=3> gives highest temperature in any March, <#ByMonthTempHT mon=3> gives the date and time for that highest temperature | <#ByMonthTempH mon=3> gives highest temperature in any March, <#ByMonthTempHT mon=3> gives the date and time for that highest temperature | ||
| Only one input parameter applies: | | Only one input parameter applies: | ||
* The value of "N" supplied should be an integer between 1 and 12 | * The value of "N" supplied should be an integer between 1 and 12 | ||
* If you don't supply an input parameter (or supply an invalid value like zero) the current month will be used. | * If you don't supply an input parameter (or supply an invalid value like zero) the current month will be used. | ||
Use without an input parameter applies if you want to write a template that will always supply values for the current month and don't want to process a script, to calculate the correct input parameter, before Cumulus processes the template. | |||
|- | |- | ||
! scope="row"| [[Webtags#Monthly|Only <#SunshineHoursMonth>]] and [[webtags#Yearly|Only <#SunshineHoursYear>]] | ! scope="row"| [[Webtags#Monthly|Only <#SunshineHoursMonth>]] and [[webtags#Yearly|Only <#SunshineHoursYear>]] | ||
| Values available for current month/year, and for past month/year | | Values available for current month/year, and for past month/year | ||
| Listed web tags take '''r=-ww''' | | Listed web tags take: '''r=-ww''' (note minus sign and up to 2 digits) | ||
* Monthly tags also take: '''m=N y=nnnn''' | * Monthly tags also take: '''m=N y=nnnn''' ('''N''' can be 1 to 12, ''nnnn'' is 4 digit year) | ||
* Yearly tags also take: '''y=nnnn''' | * Yearly tags also take: '''y=nnnn''' | ||
Omit input modification parameter to get value for current month/year | Omit input modification parameter to get value for current month/year | ||
| Line 107: | Line 116: | ||
* <#SunshineHoursMonth> gives total sunshine hours since 1 minute past midnight at start of current month | * <#SunshineHoursMonth> gives total sunshine hours since 1 minute past midnight at start of current month | ||
* <#SunshineHoursMonth y=2021 m=1> for the January 2021 total | * <#SunshineHoursMonth y=2021 m=1> for the January 2021 total | ||
* <#SunshineHoursMonth r=-1> for last | * <#SunshineHoursMonth r=-1> for last month's total | ||
* <#SunshineHoursMonth r=-12> for same month as current month, but one year ago | * <#SunshineHoursMonth r=-12> for same month as current month, but one year ago | ||
Yearly examples: | |||
* <#SunshineHoursYear> gives total sunshine hours since 1 minute past midnight on New Year's Day | * <#SunshineHoursYear> gives total sunshine hours since 1 minute past midnight on New Year's Day | ||
* <#SunshineHoursYear y=2019> for the total for 2019 | * <#SunshineHoursYear y=2019> for the total for 2019 | ||
* <#SunshineHoursYear r=-2> total for the year before last (if current year is 2021, that | * <#SunshineHoursYear r=-2> total for the year before last (if current year is 2021, that returns total for 2019 as previous example) | ||
| Returns the sunshine hours total in selected period | | Returns the sunshine hours total in selected period | ||
(You need a sensor to be monitoring this throughout selected period) | |||
|} | |} | ||
| Line 282: | Line 293: | ||
| None (all tag names combine both time and date) | | None (all tag names combine both time and date) | ||
| Any tag name in "Date/Time" column of linked table | | Any tag name in "Date/Time" column of linked table | ||
|- | |||
! scope="row"| [[Webtags#Davis]] | |||
| None | |||
| <#StormRainStart> only | |||
| None | |||
|} | |} | ||
^ For the monthly and yearly web tags, the date and time are in separate tag names. It is not possible to get both time and date out of either tag name. | ^ For the monthly and yearly web tags, the date and time are in separate tag names. It is not possible to get both time and date out of either tag name. | ||
