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:

1. Go to the Node-RED menu (hamburger icon)
2. Select "Manage palette"
3. Click "Install" tab
4. Search for "node-red-contrib-get-history-timezone"
5. Click "Install"

Usage

Configuration

1. Server: Select your Home Assistant server configuration
2. Entity ID: Specify the entity ID(s) to retrieve history for
   • Use specific ID: sensor.temperature
   • Use regex pattern: sensor\..*temperature.*
3. Time Range: Choose between:
   • Relative time: "2 hours", "1 day", "30 minutes"
   • Absolute dates: Set specific start and end dates
4. Timezone Conversion:
   • Enable to convert UTC timestamps to local timezone
   • Select target timezone or use system timezone
5. 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