TWC Weather
The $twcweather
system variable provides data from The Weather Company following the shutdown of the Weather Underground API that powered $weather
. See sample data below which is available for webCoRE installs running on the SmartThings platform.
Conditions
Expression | Sample value |
---|---|
$twcweather.conditions.cloudCeiling
|
null
|
$twcweather.conditions.cloudCoverPhrase
|
"Clear"
|
$twcweather.conditions.dayOfWeek
|
"Wednesday"
|
$twcweather.conditions.dayOrNight
|
"D"
|
$twcweather.conditions.expirationTimeUtc
|
1545249077
|
$twcweather.conditions.iconCode
|
32
|
$twcweather.conditions.iconCodeExtend
|
3200
|
$twcweather.conditions.obsQualifierCode
|
null
|
$twcweather.conditions.obsQualifierSeverity
|
null
|
$twcweather.conditions.precip1Hour
|
0
|
$twcweather.conditions.precip6Hour
|
0
|
$twcweather.conditions.precip24Hour
|
0
|
$twcweather.conditions.pressureAltimeter
|
1018.29
|
$twcweather.conditions.pressureChange
|
-2.71
|
$twcweather.conditions.pressureMeanSeaLevel
|
1018.5
|
$twcweather.conditions.pressureTendencyCode
|
2
|
$twcweather.conditions.pressureTendencyTrend
|
"Falling"
|
$twcweather.conditions.relativeHumidity
|
55
|
$twcweather.conditions.snow1Hour
|
0
|
$twcweather.conditions.snow6Hour
|
0
|
$twcweather.conditions.snow24Hour
|
0
|
$twcweather.conditions.sunriseTimeLocal
|
"2018-12-19T07:28:58-0500"
|
$twcweather.conditions.sunriseTimeUtc
|
1545222538
|
$twcweather.conditions.sunsetTimeLocal
|
"2018-12-19T17:10:52-0500"
|
$twcweather.conditions.sunsetTimeUtc
|
1545257452
|
$twcweather.conditions.temperature
|
10
|
$twcweather.conditions.temperatureChange24Hour
|
-2
|
$twcweather.conditions.temperatureDewPoint
|
2
|
$twcweather.conditions.temperatureFeelsLike
|
9
|
$twcweather.conditions.temperatureHeatIndex
|
10
|
$twcweather.conditions.temperatureMax24Hour
|
12
|
$twcweather.conditions.temperatureMaxSince7Am
|
10
|
$twcweather.conditions.temperatureMin24Hour
|
-3
|
$twcweather.conditions.temperatureWindChill
|
9
|
$twcweather.conditions.uvDescription
|
"Low"
|
$twcweather.conditions.uvIndex
|
1
|
$twcweather.conditions.validTimeLocal
|
"2018-12-19T14:41:17-0500"
|
$twcweather.conditions.validTimeUtc
|
1545248477
|
$twcweather.conditions.visibility
|
16.09
|
$twcweather.conditions.windDirection
|
180
|
$twcweather.conditions.windDirectionCardinal
|
"S"
|
$twcweather.conditions.windGust
|
null
|
$twcweather.conditions.windSpeed
|
6
|
$twcweather.conditions.wxPhraseLong
|
"Sunny"
|
$twcweather.conditions.wxPhraseMedium
|
"Sunny"
|
$twcweather.conditions.wxPhraseShort
|
"Sunny"
|
Forecast
Expression | Sample value |
---|---|
$twcweather.forecast.dayOfWeek
|
[ "Wednesday", "Thursday", "Friday", "Saturday" ] |
$twcweather.forecast.expirationTimeUtc
|
[ 1545251268, 1545251268, 1545251268, 1545251268 ] |
$twcweather.forecast.moonPhase
|
[ "Waxing Gibbous", "Waxing Gibbous", "Waxing Gibbous", "Full Moon" ] |
$twcweather.forecast.moonPhaseCode
|
[ "WXG", "WXG", "WXG", "F" ] |
$twcweather.forecast.moonPhaseDay
|
[ 11, 12, 13, 15 ] |
$twcweather.forecast.moonriseTimeLocal
|
[ "2018-12-19T15:04:06-0500", "2018-12-20T15:44:43-0500", "2018-12-21T16:32:25-0500", "2018-12-22T17:26:58-0500" ] |
$twcweather.forecast.moonriseTimeUtc
|
[ 1545249846, 1545338683, 1545427945, 1545517618 ] |
$twcweather.forecast.moonsetTimeLocal
|
[ "2018-12-19T03:50:48-0500", "2018-12-20T04:56:24-0500", "2018-12-21T06:03:51-0500", "2018-12-22T07:11:16-0500" ] |
$twcweather.forecast.moonsetTimeUtc
|
[ 1545209448, 1545299784, 1545390231, 1545480676 ] |
$twcweather.forecast.narrative
|
[ "A few clouds. Highs in the low 50s and lows in the upper 30s.", "Cloudy, periods of rain. Highs in the upper 40s with temperatures nearly steady overnight.", "Cloudy with rain. Highs in the mid 50s and lows in the upper 30s.", "Mostly sunny. Highs in the upper 40s and lows in the low 30s." ] |
$twcweather.forecast.qpf
|
[ 0, 1.44, 0.49, 0 ] |
$twcweather.forecast.qpfSnow
|
[ 0, 0, 0, 0 ] |
$twcweather.forecast.sunriseTimeLocal
|
[ "2018-12-19T07:28:58-0500", "2018-12-20T07:29:31-0500", "2018-12-21T07:30:02-0500", "2018-12-22T07:30:32-0500" ] |
$twcweather.forecast.sunriseTimeUtc
|
[ 1545222538, 1545308971, 1545395402, 1545481832 ] |
$twcweather.forecast.sunsetTimeLocal
|
[ "2018-12-19T17:10:52-0500", "2018-12-20T17:11:19-0500", "2018-12-21T17:11:47-0500", "2018-12-22T17:12:18-0500" ] |
$twcweather.forecast.sunsetTimeUtc
|
[ 1545257452, 1545343879, 1545430307, 1545516738 ] |
$twcweather.forecast.temperatureMax
|
[ 51, 49, 54, 49 ] |
$twcweather.forecast.temperatureMin
|
[ 38, 47, 37, 31 ] |
$twcweather.forecast.validTimeLocal
|
[ "2018-12-19T07:00:00-0500", "2018-12-20T07:00:00-0500", "2018-12-21T07:00:00-0500", "2018-12-22T07:00:00-0500" ] |
$twcweather.forecast.validTimeUtc
|
[ 1545220800, 1545307200, 1545393600, 1545480000 ] |
$twcweather.forecast.daypart[0].cloudCover
|
[ 16, 79, 100, 100, 99, 85, 32, 14 ] |
$twcweather.forecast.daypart[0].dayOrNight
|
[ "D", "N", "D", "N", "D", "N", "D", "N" ] |
$twcweather.forecast.daypart[0].daypartName
|
[ "Today", "Tonight", "Tomorrow", "Tomorrow night", "Friday", "Friday night", "Saturday", "Saturday night" ] |
$twcweather.forecast.daypart[0].iconCode
|
[ 34, 27, 12, 12, 12, 26, 34, 33 ] |
$twcweather.forecast.daypart[0].iconCodeExtend
|
[ 3400, 2700, 1200, 1200, 1200, 2600, 3400, 3300 ] |
$twcweather.forecast.daypart[0].narrative
|
[ "Lots of sunshine. High 51F. Winds light and variable.", "Partly cloudy early followed by cloudy skies overnight. Low 38F. Winds light and variable.", "Rain likely. High 49F. Winds NE at 5 to 10 mph. Chance of rain 100%. Rainfall near an inch.", "Rain likely. Low 47F. Winds light and variable. Chance of rain 90%. Rainfall near a half an inch.", "Periods of rain. Thunder possible. High 54F. Winds SSW at 5 to 10 mph. Chance of rain 100%.", "Cloudy. Low 37F. Winds WNW at 5 to 10 mph.", "A few clouds early, otherwise mostly sunny. High 49F. Winds WNW at 5 to 10 mph.", "Clear to partly cloudy. Low 31F. Winds light and variable." ] |
$twcweather.forecast.daypart[0].precipChance
|
[ 0, 20, 100, 90, 100, 20, 0, 0 ] |
$twcweather.forecast.daypart[0].precipType
|
[ "rain", "precip", "rain", "rain", "rain", "precip", "rain", "precip" ] |
$twcweather.forecast.daypart[0].qpf
|
[ 0, 0, 0.93, 0.51, 0.48, 0, 0, 0 ] |
$twcweather.forecast.daypart[0].qpfSnow
|
[ 0, 0, 0, 0, 0, 0, 0, 0 ] |
$twcweather.forecast.daypart[0].qualifierCode
|
[ null, null, null, null, "Q8003", null, null, null ] |
$twcweather.forecast.daypart[0].qualifierPhrase
|
[ null, null, null, null, "Thunder possible.", null, null, null ] |
$twcweather.forecast.daypart[0].relativeHumidity
|
[ 63, 85, 93, 96, 92, 76, 55, 72 ] |
$twcweather.forecast.daypart[0].snowRange
|
[ "", "", "", "", "", "", "", "" ] |
$twcweather.forecast.daypart[0].temperature
|
[ 51, 38, 49, 47, 54, 37, 49, 31 ] |
$twcweather.forecast.daypart[0].temperatureHeatIndex
|
[ 50, 43, 48, 50, 54, 46, 48, 39 ] |
$twcweather.forecast.daypart[0].temperatureWindChill
|
[ 44, 39, 41, 46, 43, 34, 33, 32 ] |
$twcweather.forecast.daypart[0].thunderCategory
|
[ "No thunder", "No thunder", "No thunder", "No thunder", "Thunder possible", "No thunder", "No thunder", "No thunder" ] |
$twcweather.forecast.daypart[0].thunderIndex
|
[ 0, 0, 0, 0, 1, 0, 0, 0 ] |
$twcweather.forecast.daypart[0].uvDescription
|
[ "Low", "Low", "Low", "Low", "Low", "Low", "Low", "Low" ] |
$twcweather.forecast.daypart[0].uvIndex
|
[ 1, 0, 1, 0, 1, 0, 2, 0 ] |
$twcweather.forecast.daypart[0].windDirection
|
[ 173, 44, 51, 125, 208, 292, 282, 274 ] |
$twcweather.forecast.daypart[0].windDirectionCardinal
|
[ "S", "NE", "NE", "SE", "SSW", "WNW", "WNW", "W" ] |
$twcweather.forecast.daypart[0].windPhrase
|
[ "Winds light and variable.", "Winds light and variable.", "Winds NE at 5 to 10 mph.", "Winds light and variable.", "Winds SSW at 5 to 10 mph.", "Winds WNW at 5 to 10 mph.", "Winds WNW at 5 to 10 mph.", "Winds light and variable." ] |
$twcweather.forecast.daypart[0].windSpeed
|
[ 3, 1, 6, 5, 9, 9, 9, 3 ] |
$twcweather.forecast.daypart[0].wxPhraseLong
|
[ "Mostly Sunny", "Mostly Cloudy", "Rain", "Rain", "Rain", "Cloudy", "Mostly Sunny", "Mostly Clear" ] |
$twcweather.forecast.daypart[0].wxPhraseShort
|
[ "M Sunny", "M Cloudy", "Rain", "Rain", "Rain", "Cloudy", "M Sunny", "M Clear" ] |
Weather Icons
Usage
Choose an icon set below and use it with the iconCode values from $twcweather
. The following examples can be used in the Value field.
Current Weather using the "TWC" icon set: :twc-{$twcweather.conditions.iconCode}:
Forecast Day using the "WU v4" icon set: :wu-v4-{$twcweather.forecast.daypart[0].iconCode[INDEX]}
note: You will need to change [INDEX] to a value from 0-7 (0 being the next forecasted half day/night and 7 being the 3rd day/night)
Code | Description | TWC Icon | WU v4 Icon | Night or Daytime |
---|---|---|---|---|
0 | Tornado | Night and Day | ||
1 | Tropical Storm | Night and Day | ||
2 | Hurricane | Night and Day | ||
3 | Strong Storms | Night and Day | ||
4 | Thunder and Hail | Night and Day | ||
5 | Rain to Snow Showers | Night and Day | ||
6 | Rain / Sleet | Night and Day | ||
7 | Wintry Mix Snow / Sleet | Night and Day | ||
8 | Freezing Drizzle | Night and Day | ||
9 | Drizzle | Night and Day | ||
10 | Freezing Rain | Night and Day | ||
11 | Light Rain | Night and Day | ||
12 | Rain | Night and Day | ||
13 | Scattered Flurries | Night and Day | ||
14 | Light Snow | Night and Day | ||
15 | Blowing / Drifting Snow | Night and Day | ||
16 | Snow | Night and Day | ||
17 | Hail | Night and Day | ||
18 | Sleet | Night and Day | ||
19 | Blowing Dust / Sandstorm | Night and Day | ||
20 | Foggy | Night and Day | ||
21 | Haze / Windy | Night and Day | ||
22 | Smoke / Windy | Night and Day | ||
23 | Breezy | Night and Day | ||
24 | Blowing Spray / Windy | Night and Day | ||
25 | Frigid / Ice Crystals | Night and Day | ||
26 | Cloudy | Night and Day | ||
27 | Mostly Cloudy | Night | ||
28 | Mostly Cloudy | Day | ||
29 | Partly Cloudy | Night | ||
30 | Partly Cloudy | Day | ||
31 | Clear | Night | ||
32 | Sunny | Day | ||
33 | Fair / Mostly Clear | Night | ||
34 | Fair / Mostly Sunny | Day | ||
35 | Mixed Rain & Hail | Day | ||
36 | Hot | Day | ||
37 | Isolated Thunderstorms | Day | ||
38 | Thunderstorms | Night and Day | ||
39 | Scattered Showers | Day | ||
40 | Heavy Rain | Night and Day | ||
41 | Scattered Snow Showers | Day | ||
42 | Heavy Snow | Night and Day | ||
43 | Blizzard | Night and Day | ||
44 | Not Available (N/A) | Night and Day | ||
45 | Scattered Showers | Night | ||
46 | Scattered Snow Showers | Night | ||
47 | Scattered Thunderstorms | Night |
Old icon sets
Several additional icon sets are available but all have a much more limited set of icons. We have ensured that the $twcWeather
icon code numbers map to an approximately accurate representation in the old icon sets. While the old sets work we encourage use of the more expressive TWC and WU v4 icon sets.
All of the icon sets described on the original Weather#Weather_Icons page work with the new codes, for example :wu-b-36:
maps to the "sunny" icon in the "B" icon set.