Time Machine for Weather

Platform: API iOS Android

Get the last 10 days of weather history data.

Let’s say, today is December 30, you can get historical data from Dec. 20 to Dec. 29.

QWeather also provides historical reanalysis weather data from 2000 to present. If you need long time historical weather data data, please provide the following information to sales@qweather.com.

  • Company name
  • Contact information
  • City or coordinates
  • Date range
Interface Code Interface Class
getWeatherHistorical Historical weather data HistoryWeatherBean


  • location(required)The location to be queried, only support LocationID and LocationID can be obtained by GeoAPI. For example: location=101010100
  • date(required)Set the date, up to the most recent 10 days. The date format is yyyyMMdd. Example: date=20200531
  • langMulti-language setting, please see Language to find out how our multi-language works and how to set up.
  • unitSet weather data unit, the available value are unit=m for metric(default) and unit=i for imperial. See more about Unit.

Sample Code

QWeather.getHistoricalWeather(Context context, String location, String date, QWeather.OnResultWeatherHistoricalBeanListener listener);

QWeather.getHistoricalWeather(Context context, String location, String date, Lang lang, Unit unit,QWeather.OnResultWeatherHistoricalBeanListener listener)


Properties of HistoryWeatherBean

Property Description Example
getCode See Status Code 200
getDailyBean Overview of the daily forecast DailyBean
getHourlyBeans Hourly data of the day List<HourlyBean>
getRefer Reference data, includes data source, statements and license Refer
getBasic Basic Information Basic


Property Description Example
getSourcesList Data source and other statements QWeather
getLicenseList Data license QWeather Developers License


Property Description Example
getUpdateTime Last updated time 2017-10-25T04:34+08:00
getFxLink Responsive web page of this location, easy to embed in your website or APP https://www.qweather.com/historical/beijing-101010100.html


Property Description Example
getDate Forecast date 2013-12-30
getSunrise Sunrise time. Maybe null in high latitude area 07:36
getSunset Sunset time. Maybe null in high latitude area 16:58
getMoonRise Moonrise time of current day. Maybe null 04:47
getMoonSet Moonset time of current day. Maybe null 14:59
getMoonPhase Moon Phase Full Moon
getTempMax The highest temperature of the day 4
getTempMin The lowest temperature of the day -5
getHumidity Relative humidity, in percent 37
getPrecip Precipitation 0
getPressure Atmospheric pressure 1018


Property Description Example
getTime Historical weather time of the day 2013-12-30T13:00+08:00
getTemp Temperature 2
getIcon Icon code for weather conditions. See also QWeather Icons 101
getText Weather conditions Cloudy
getWind360 Wind direction in azimuth degree 290
getWindDir Wind direction NW
getWindScale Wind scale 3-4
getWindSpeed ​​ Wind speed ​​ 15
getHumidity Relative humidity in percent 30
getPressure Atmospheric pressure 1030
getPrecip Precipitation 1.2