gives the most recent forecast for all weather forecast properties for the specified location.


gives the forecast for the specified property for the current location.


gives the forecast at the time or times specified by date for all properties at the current location.


gives the forecast for the property at the specified location.


gives the forecast at the time or times specified by datespec for the property at the location.

Details and Options

  • WeatherForecastData gives weather forecast data worldwide.
  • WeatherForecastData[] returns the most recent forecast for all forecast properties for the current location.
  • WeatherForecastData[] makes use of $GeoLocation and $TimeZone to determine your location and time zone.
  • The location can be specified as an ICAO code such as "KNYC", a WMO code such as "WMO12345", an amateur weather station code such as "C1234", or another standardized weather station identifier.
  • The location can also be specified by latitude/longitude pairs, assuming degrees as units, a GeoPosition specification, or Entity objects, assuming they represent objects with geographic coordinates. They can also be GeoGraphics primitives such as GeoDisk, or a city specification of the type used in CityData.
  • date should be specified as a DateObject or {start,end,step} where start and end are both a DateObject.
  • datespec can be specified as a date list, a DateObject, or as a string in DateString format.
  • WeatherForecastData takes datespec to be given by $TimeZone unless otherwise specified by a DateObject. Results are returned in UTC.
  • When specific times are given, an interpolated result for that time is returned. datespec specifications for a day or longer period return the interval of property forecasts.
  • datespec can be specified as {start,end,step} for compatibility with DateRange specifications. step can be All or "Day". All gives all forecast values. If omitted, step is assumed to have the value All.
  • Location and date can also be specified together as Association["Location"->loc,"Date"datespec].
  • WeatherForecastData[loc,prop,datespec,func] is used to specify the format of output when locations are specified.
  • Possible settings for func include:
  • Automaticreturn intervals for extended locations and indeterminate times
    Intervalreturn intervals for extended locations and times
    Maxreturn maximum values for extended locations and times
    Meanreturn mean value for extended locations and times
    Minreturn minumum values for extended locations and times
    StandardDeviationreturn standard deviation for extended locations and times
  • Alternate argument structures supported include WeatherForecastData[loc,date], WeatherForecastData[prop,date], WeatherForecastData[date,prop], WeatherForecastData[loc,func], WeatherForecastData[loc,date,func], and WeatherForecastData[loc,prop,func].
  • The option UnitSystem is available for controlling the units of the results. The following settings can be used:
  • "Imperial"return results in imperial units
    "Metric"return results in metric units
  • Data is only available for up to a week in the future.
  • Instantaneous forecast properties:
  • "CloudCoverFraction"fraction of the sky obscured by cloud cover
    "Humidity"relative humidity
    "PrecipitationRate"average precipitation rate
    "Pressure"barometric pressure
    "StationPressure"pressure, uncorrected for elevation
    "WindChill"wind chill temperature
    "WindDirection"wind direction in degrees
    "WindSpeed"wind gust speed
  • Properties aggregated over periods between forecast times include:
  • "PrecipitationAmount"precipitation amount
    "PrecipitationTypes"types of precipitation forecasted (hail, rain, snow)
  • Aggregate properties available for "Day" increments:
  • "MaxTemperature"maximum temperature
    "MaxWindSpeed"maximum wind speed
    "MeanHumidity"mean relative humidity
    "MeanPressure"mean pressure
    "MeanStationPressure"mean station pressure
    "MeanTemperature"mean temperature
    "MeanWindChill"mean wind chill temperature
    "MeanWindSpeed"mean wind speed
    "MinTemperature"minimum temperature
    "TotalPrecipitation"precipitation amount
  • WeatherForecastData is assembled from a variety of sources, including the Global Forecast System and the North American Mesoscale Forecast System.


open allclose all

Basic Examples  (1)

Find the temperatures for tomorrow at 3pm:

Find the forecast highs for Miami over the next week:

Chart the cloud coverage over the next week:

Scope  (12)

Properties  (1)

Find all available properties:

Location Specification  (5)

Examine the weather forecast for your current location:

Observe the current forecast for cloud coverage at the approximate coordinates of "KBOS":

Coordinates can be supplied for a location:

Entity objects can be used:

Obtain the appropriate Entity using free-form input ():

Find the maximum forecast temperatures across a geographic region:

Date Specification  (4)

Dates can be input using DateObject:

Dates can also be specified in DateList format:

Date ranges in the format {start,end} will return all recorded data within that range:

Examine property aggregated over time periods:

Format Specification  (1)

Find the high temperature forecasts for an extended location:

Obtain the maximum or minimum forecast highs:

Use the setting Mean to obtain the average high temperature:

Association Specification  (1)

Date and location can be specified together using Association:

Options  (2)

UnitSystem  (2)

By default, results use the format given by $UnitSystem:

Set UnitSystem to "Imperial" to specify inches of Mercury:

Or set UnitSystem to "Metric" to specify millibars:

UnitConvert can also be used to adjust the units:

Applications  (4)

Compare forecast mean temperatures for the week with those of the prior 10 years:

Examine total rainfall amounts for capital cities in Europe for the coming week:

Examine and contrast the difference in temperature ranges across different regions:

Compare the standard deviations:

Examine the forecast for the coming week:

Properties & Relations  (4)

Calculate the low altitude pressures based on local forecasts and FormulaData:

Convert the result to millibars:

Use forecasts to calculate the density of air using ThermodynamicData:

Use IconData to display different forecast properties:

Use GeoGraphics and IconData to display the forecast high temperatures for today at a selection of cities within Germany:

Wolfram Research (2016), WeatherForecastData, Wolfram Language function,


Wolfram Research (2016), WeatherForecastData, Wolfram Language function,


@misc{reference.wolfram_2020_weatherforecastdata, author="Wolfram Research", title="{WeatherForecastData}", year="2016", howpublished="\url{}", note=[Accessed: 19-January-2021 ]}


@online{reference.wolfram_2020_weatherforecastdata, organization={Wolfram Research}, title={WeatherForecastData}, year={2016}, url={}, note=[Accessed: 19-January-2021 ]}


Wolfram Language. 2016. "WeatherForecastData." Wolfram Language & System Documentation Center. Wolfram Research.


Wolfram Language. (2016). WeatherForecastData. Wolfram Language & System Documentation Center. Retrieved from