node-red-contrib-get-history-timezone

node-red-contrib-get-history-timezone

A Node-RED node for retrieving Home Assistant historical data with timezone conversion support.

Features

• Retrieve historical data from Home Assistant
• Convert UTC timestamps to any timezone
• Support for relative time periods (e.g., "2 hours", "1 day")
• Entity filtering with regex support
• Configurable output format

Installation

Install from npm:

npm install node-red-contrib-get-history-timezone

Or install directly in Node-RED:

• Go to the Node-RED menu (hamburger icon)
• Select "Manage palette"
• Click "Install" tab
• Search for "node-red-contrib-get-history-timezone"
• Click "Install"

Usage

Configuration

• Server: Select your Home Assistant server configuration
• Entity ID: Specify the entity ID(s) to retrieve history for
  • Use specific ID: sensor.temperature
  • Use regex pattern: sensor\..*temperature.*
• Time Range: Choose between:
  • Relative time: "2 hours", "1 day", "30 minutes"
  • Absolute dates: Set specific start and end dates
• Timezone Conversion:
  • Enable to convert UTC timestamps to local timezone
  • Select target timezone or use system timezone
• Output Options:
  • Flatten results: Returns flat array vs nested arrays
  • Output location: Where to store results in the message

Input Message

You can override configuration via the input message:

msg = {
    payload: {
        entityId: "sensor.temperature",
        relativeTime: "2 hours",
        convertTimezone: true,
        timezone: "Europe/Warsaw",
        flatten: true
    }
};

Output

The node outputs historical data with optionally converted timestamps:

[
    {
        "entity_id": "sensor.temperature",
        "state": "23.5",
        "attributes": {...},
        "last_changed": "2025-10-06T14:57:55.374689+02:00",  // Converted to local timezone
        "last_updated": "2025-10-06T14:57:55.374689+02:00"   // Converted to local timezone
    }
]

Timezone Support

The node supports timezone conversion using standard IANA timezone identifiers:

• system - Use Node-RED server's system timezone
• Europe/Warsaw - Polish timezone
• Europe/London - UK timezone
• America/New_York - Eastern US timezone
• UTC - Coordinated Universal Time
• Any other valid IANA timezone identifier

Requirements

• Node-RED 3.0.0+
• Home Assistant with REST API access
• Valid Home Assistant access token

License

MIT

Contributing

Issues and pull requests are welcome on GitHub.

Changelog

1.0.0

• Initial release with timezone conversion support
• Support for relative time periods
• Entity filtering with regex
• Configurable output options