🧩 Text2Date Pro — Documentation 🔧 How to Use Text2Date Pro
1. Install the Plugin
Add Text2Date Pro to your Bubble app from the plugin marketplace.

2. Set Up the Action
Use the “Convert Text to Date” action in your workflow where you need to convert a text input into a valid date object.

⦁ date_text — the text string provided by the user (e.g., "12/24/2024 3:30 PM").
⦁ timezone — pass the Current geographic position’s time zone ID (see example below).

🌍 Timezone Handling

⦁ Bubble automatically requests access to the user’s geographic position if permission hasn’t already been granted.
⦁ The plugin uses the current geographic position’s timezone ID for accurate conversion.
⦁ If the timezone cannot be retrieved, the plugin defaults to "UTC".

(Tip: Simply bind the timezone field to Current geographic position’s time zone ID in Bubble — the plugin will handle it automatically.)

📅 Supported Date & Time Formats

Text2Date Pro recognizes a wide range of common formats for both date-only and date-time inputs:

⦁ M/d/yyyy h:mm a     → 12/24/2024 3:30 PM
⦁ M/d/yyyy H:mm       → 12/24/2024 15:30
⦁ yyyy/M/d H:mm       → 2024/12/24 15:30
⦁ yyyy-M-d H:mm       → 2024-12-24 15:30
⦁ MMM d yyyy h:mm a   → Dec 24 2024 3:30 PM
⦁ MMM d, yyyy h:mm a  → Dec 24, 2024 3:30 PM

You can also pass simple date-only inputs such as "12/24/2024" or "2024-12-24".
If a time is included and has already passed for the current day, the plugin automatically shifts the result to the next day while preserving the time.

📤 Outputs

The plugin returns:
⦁ parsed_date — a clean JavaScript Date object in UTC, ready to use in workflows, database fields, or date/time calculations.

🌐 Examples Across Timezones

Input: "12/24/2024"
Timezone: America/New_York
→ 2024-12-24T05:00:00.000Z (Midnight EST → UTC)

Input: "12/24/2024"
Timezone: Europe/London
→ 2024-12-24T00:00:00.000Z (Midnight GMT → UTC)

Input: "12/24/2024"
Timezone: Asia/Kolkata
→ 2024-12-23T18:30:00.000Z (Midnight IST → UTC)

Input: "12/24/2024 3:30 PM"
Timezone: America/Los_Angeles
→ 2024-12-25T00:30:00.000Z (PST → UTC)

💡 Pro Tips

⦁ If your app doesn’t have location permissions yet, consider adding a small message or tooltip asking users to allow location access for accurate timezone detection.
⦁ For static conversions (not based on location), you can manually pass a timezone string like "America/New_York" or "Asia/Tokyo".
⦁ Use Bubble’s built-in :formatted as operator to display the parsed date in any desired local format.