Help Documentation
Epoch Converter Pro User Guide
๐ Table of Contents
- ๐ Quick Start
- ๐ฑ Navigation
- ๐ Understanding the Live Clock
- ๐ Section 1: Converter (Main)
- ๐ ๏ธ Section 2: Tools (Advanced Features)
- ๐ฆ Section 3: Batch Process
- ๐ Section 4: History
- ๐งช Section 5: API Tester
- โ๏ธ Settings & Customization
- โฟ Accessibility Features
- ๐ Shareable URLs
- ๐ฑ Install on Your Desktop or Home Screen
- ๐ก Tips & Tricks
- ๐ Use Cases & Examples
- ๐ Troubleshooting
- โ FAQ
- ๐ Technical Support
๐ Quick Start
Opening the Application
- Open the page: Go to Epoch Converter Pro in any modern browser
- That's it! No installation, no setup required
Recommended Browsers:
- Google Chrome 90+
- Firefox 88+
- Safari 14+
- Microsoft Edge 90+
First Look
When you open the application, you'll see:
- Header - Navigation menu and theme toggle (top of screen)
- Live Clock - Real-time display showing current time in multiple formats
- Converter Section - Main conversion tools (default view)
- Stats Bar - Current settings display at the bottom of the header
What Makes Epoch Converter Pro Special
Epoch Converter Pro is a Unix timestamp converter that runs entirely in your browser:
- Bidirectional Conversion: Convert epoch to date and date to epoch with auto-detection
- 9 Advanced Tools: Multi-timezone, duration, countdown, age, working days, diff, code generator, cron, ISO 8601
- Developer Tools: Generate conversion code in 6 programming languages (JS, Python, Java, PHP, Go, Ruby)
- Batch Processing: Convert multiple timestamps with CSV/JSON/Excel export
- Accessibility: Screen reader announcements, adjustable font size and a reduced motion option
- Complete Privacy: All processing happens locally, no conversion runs on a server
- Installable: Chrome and Edge can add it to your desktop or home screen in its own window; it still needs a connection to open
๐ How Your Data Is Handled
All timestamp conversions happen locally in your browser using pure JavaScript. Your timestamps are never uploaded to servers, ensuring complete privacy and security. History is stored only in your browser's localStorage and never leaves your device. No account or sign-up is ever needed.
๐ฑ Navigation
Desktop Navigation
At the top of the page, you'll find 5 main sections:
- Converter ๐ - Main conversion tools
- Tools ๐ ๏ธ - Advanced time utilities
- Batch ๐ฆ - Process multiple timestamps at once
- History ๐ - View your conversion history
- API Tester ๐งช - Test API timestamp responses
Click any section name to switch views.
Mobile Navigation
On mobile devices:
- Hamburger Menu (โฐ) - Top-left corner opens slide-out menu
- Bottom Navigation Bar - Tap icons to switch sections
- Swipe to dismiss the hamburger menu or tap outside it
๐ Understanding the Live Clock
The live clock (top of converter section) displays the current time in three formats:
- Unix Epoch - Seconds since January 1, 1970 (e.g.,
1709482800) - ISO 8601 - International standard format (e.g.,
2024-03-03T15:00:00.000Z) - Human Readable - Easy-to-read format (e.g., "Sunday, March 3, 2024 3:00:00 PM")
The clock updates every second automatically.
๐ Section 1: Converter (Main)
This is your primary workspace for converting between epochs and dates.
A. Epoch to Date Conversion
What it does: Converts Unix timestamps into readable dates
How to use:
- Locate the "Epoch Timestamp" input field (left side)
- Enter any Unix timestamp (e.g.,
1709482800) - Click "Convert" button
- Results appear immediately below showing:
- Local time
- UTC time
- ISO 8601 format
- Unix timestamp (seconds)
- Unix timestamp (milliseconds)
Supported Formats (Auto-Detection):
- Seconds (10 digits):
1709482800 - Milliseconds (13 digits):
1709482800000 - Microseconds (16 digits):
1709482800000000 - Nanoseconds (>16 digits):
1709482800000000000
The app auto-detects which format you're using!
Example:
Input: 1709482800
Output:
- Local: Sunday, March 3, 2024 3:00:00 PM
- UTC: Sunday, March 3, 2024 8:00:00 PM
- ISO 8601: 2024-03-03T20:00:00.000Z
B. Date to Epoch Conversion
What it does: Converts readable dates into Unix timestamps
How to use:
- Locate the "Date/Time" input field (right side)
- Enter a date in any of these formats:
- ISO format:
2024-03-03T15:00:00 - US format:
03/03/2024or03-03-2024 - European format:
03/03/2024or03-03-2024 - Natural language:
March 3, 2024
- ISO format:
- Click "Convert" button
- Results appear showing Unix timestamps and ISO format
Pro Tip: You can also click the calendar icon to pick a date visually!
C. Quick Actions (8 Preset Buttons)
Located below the converters, these buttons instantly convert common timepoints:
- Now - Current moment (updates live)
- Today Start - Beginning of today (12:00 AM)
- Today End - End of today (11:59:59 PM)
- Yesterday - Same time yesterday
- Tomorrow - Same time tomorrow
- Week Start - Beginning of current week (Monday 12:00 AM)
- Month Start - Beginning of current month (1st day, 12:00 AM)
- Year Start - Beginning of current year (January 1, 12:00 AM)
How to use: Simply click any button and both converters update automatically!
D. Relative Time Calculator
What it does: Calculate timestamps relative to now (past or future)
Location: Below quick actions
How to use:
- Enter a number in the input field (e.g.,
5) - Select a time unit from dropdown (Minutes, Hours, Days, Weeks, Months, Years)
- Click "Add" to calculate future time
- Click "Subtract" to calculate past time
- Results appear in both converters
Example:
- Add 5 Days โ Shows timestamp for 5 days from now
- Subtract 2 Hours โ Shows timestamp for 2 hours ago
๐ ๏ธ Section 2: Tools (Advanced Features)
Access 9 powerful time utilities by clicking "Tools" in the navigation.
Tool 1: Multi-Timezone Comparison
What it does: View the same moment across 8 different timezones
How to use:
- Enter an epoch timestamp or use "Now" button
- View time in 8 major timezones:
- Local (your computer's timezone)
- UTC (Coordinated Universal Time)
- New York (EST/EDT)
- London (GMT/BST)
- Tokyo (JST)
- Sydney (AEDT/AEDT)
- Dubai (GST)
- Los Angeles (PST/PDT)
- DST (Daylight Saving Time) is automatically indicated
Use Case: Scheduling international meetings, coordinating with remote teams
Tool 2: Duration Calculator
What it does: Calculate the exact time difference between two dates
How to use:
- Enter Start Date (or pick from calendar)
- Enter End Date (or pick from calendar)
- Click "Calculate Duration"
- See detailed breakdown: Years, Months, Weeks, Days, Hours, Minutes, Seconds, Milliseconds
Example:
Start: January 1, 2024
End: March 15, 2024
Result: 2 months, 2 weeks, 0 days (74 days total)
Use Case: Project timelines, age calculations, subscription periods
Tool 3: Countdown/Countup Timer
What it does: Live timer counting down to (or up from) a specific date
How to use:
- Enter target date/time
- Click "Start Timer"
- Watch live countdown display (updates every second): Format:
DD:HH:MM:SS - Click "Stop" to pause
- Click "Reset" to clear
Modes:
- Countdown - If target is in the future (e.g., "5 days until launch")
- Countup - If target is in the past (e.g., "Project started 30 days ago")
Use Case: Product launches, event countdowns, deadline tracking
Tool 4: Working Days Calculator
What it does: Count business days between two dates (excludes weekends)
How to use:
- Enter Start Date
- Enter End Date
- Click "Calculate"
- Results show: Total calendar days, Working days (Monday-Friday), Weekend days excluded
Use Case: Project planning, billing calculations, delivery estimates
Tool 5: Age Calculator
What it does: Calculate precise age from birthdate with next birthday countdown
How to use:
- Enter your birthdate (e.g.,
05/15/1990) - Click "Calculate Age"
- See: Age in years/months/days, Total days lived, Next birthday date, Days until next birthday
Use Case: Personal records, age verification, milestone tracking
Tool 6: Timestamp Difference Calculator
What it does: Compare two epochs and show human-readable difference
How to use:
- Enter First Timestamp (e.g.,
1709482800) - Enter Second Timestamp (e.g.,
1709569200) - Click "Calculate Difference"
- See difference in human-readable format (e.g., "24 hours", "3 days, 2 hours")
Use Case: API response analysis, log file comparison, event timing
Tool 7: Code Snippet Generator
What it does: Generate ready-to-use code for getting timestamps in 6 languages
How to use:
- Select programming language from dropdown: JavaScript, Python, Java, PHP, Go, Ruby
- View generated code snippet
- Click "Copy" button to copy to clipboard
- Paste into your project
Use Case: Quick reference, learning, development
Tool 8: Cron Expression Converter
What it does: Convert cron expressions into human-readable descriptions
How to use:
- Enter a cron expression (e.g.,
0 0 * * *) - Click "Parse Cron"
- See human-readable explanation
Examples:
0 0 * * *โ "At 12:00 AM, every day"*/15 * * * *โ "Every 15 minutes"0 9 * * 1-5โ "At 9:00 AM, Monday through Friday"
Use Case: Server scheduling, task automation, understanding cron jobs
Tool 9: ISO 8601 Duration Parser
What it does: Parse ISO 8601 duration strings into readable components
How to use:
- Enter ISO 8601 duration (e.g.,
P3Y6M4DT12H30M5S) - Click "Parse Duration"
- See breakdown: Years, Months, Days, Hours, Minutes, Seconds, Total duration in various units
ISO 8601 Duration Format:
P= Period (starts the duration)Y= YearsM= Months (before T) or Minutes (after T)D= DaysT= Time separatorH= HoursS= Seconds
Use Case: API data parsing, calendar calculations, time range specifications
๐ฆ Section 3: Batch Process
Process multiple timestamps at once using file import or manual entry.
A. Manual Batch Entry
How to use:
- Click "Batch" in navigation
- In the text area, enter one timestamp or date per line
- Select conversion direction: Epoch โ Date or Date โ Epoch
- Click "Process Batch"
- View results in structured format
B. File Import (Drag & Drop)
What it does: Import timestamps from files automatically
Supported Formats:
- TXT - Plain text, one timestamp per line
- CSV - Comma-separated values (first column used)
- JSON - JSON array of timestamps
How to use:
Method 1: Drag & Drop
- Drag a file from your computer
- Drop it into the designated drop zone (dashed border area)
- File contents load automatically
- Select conversion direction and click "Process Batch"
Method 2: File Picker
- Click "Choose File" button
- Browse and select your file
- File contents load automatically
- Select conversion direction and click "Process Batch"
C. Export Results
After processing, export your results in multiple formats:
Export Options:
- CSV - Comma-separated values for Excel/Sheets
- JSON - Structured data for programming
- Excel - XLS format for Microsoft Excel
How to export:
- Process your batch (results appear)
- Click "Export as CSV", "Export as JSON", or "Export as Excel"
- File downloads automatically to your Downloads folder
- Filename format:
batch_conversion_YYYYMMDD_HHMMSS.csv
Copy to Clipboard:
- Click "Copy Output" to copy all results as text
- Paste into any application
๐ Section 4: History
Track and manage your conversion history (last 100 conversions).
Viewing History
Location: Click "History" in navigation
What you see:
- List of recent conversions (newest first)
- Each entry shows: Original input, Converted output, Conversion type, Time ago (e.g., "5 minutes ago"), Copy button
Searching History
Real-time Search:
- Type in the "Search history..." input field
- Results filter instantly as you type
- Searches both input and output values
- Clear search to see all results
Filtering by Type
Filter Options:
- All - Show all conversions (default)
- Epoch โ Date - Show only epoch-to-date conversions
- Date โ Epoch - Show only date-to-epoch conversions
Copying from History
Quick Copy:
- Find the conversion you want
- Click the "Copy" button (๐ icon)
- Result copied to clipboard
- Notification appears: "Copied to clipboard!"
Clearing History
Remove all history:
- Click "Clear History" button (bottom of history section)
- Confirmation dialog appears
- Click "Yes, Clear" to confirm or "Cancel" to abort
- History deleted from browser storage
Note: This action cannot be undone!
๐งช Section 5: API Tester
Test and simulate API endpoints that work with timestamps.
What it does
Simulate HTTP requests with timestamp-based metrics and responses.
How to use
- Select HTTP Method: GET (retrieve data), POST (send data), PUT (update data), DELETE (remove data)
- Enter API Endpoint: Type or paste URL (e.g.,
https://api.example.com/time) - Add Headers (Optional): Click "Add Header", Enter key-value pairs
- Add Request Body (for POST/PUT): Enter JSON data in text area
- Click "Send Request"
- View Results: Response status, Response time, Response body, Timestamp metadata
Note: This is a simulation tool for testing - it doesn't make real HTTP requests. Use it to plan API integrations and understand timestamp handling.
โ๏ธ Settings & Customization
A. Theme Toggle
Switch between Light and Dark mode:
Desktop:
- Look for the moon/sun icon in the top-right corner
- Click to toggle between dark and light themes
- Preference saved automatically
Mobile:
- Open hamburger menu (โฐ)
- Click theme toggle icon
- Menu closes automatically
Auto-Detection: App automatically detects your system theme preference and can be manually overridden at any time
B. Settings Panel
Access settings:
- Look for the gear icon (โ๏ธ) in the header
- Click to open Settings modal
- Configure preferences
Available Settings:
- Timezone: Local (default), UTC, New York, London, Tokyo, Sydney, Dubai, Los Angeles
- Date Format: ISO (2024-03-03), US (03/03/2024), European (03/03/2024)
- Time Format: 24-hour (15:00) or 12-hour (3:00 PM)
- Timestamp Precision: Seconds, Milliseconds, Microseconds, Nanoseconds
- Other Options: Auto-save to history, Show notifications
C. Export/Import Settings
Export Your Settings:
- Open Settings panel (โ๏ธ)
- Click "Export Settings"
- JSON file downloads:
epoch_converter_settings.json - Save for backup or sharing
Import Settings:
- Open Settings panel (โ๏ธ)
- Click "Import Settings"
- Select your exported JSON file
- Settings load immediately
๐ Shareable URLs
How to Create Shareable Links
After any conversion:
- Complete a conversion (epoch or date)
- Look for "Share" button below results
- Click to generate shareable URL
- URL copies to clipboard automatically
- Share via email, chat, documentation, etc.
How Shareable Links Work
When someone opens your link:
- Page loads with your conversion data
- Converters auto-populate with values
- Results display immediately
- Recipient can modify and continue working
Use Cases: Share specific timestamps with team members, Document API responses, Create clickable references in wikis, Include in bug reports
โฟ Accessibility Features
Epoch Converter Pro has keyboard shortcuts and its own accessibility settings.
A. Keyboard Shortcuts
Full keyboard navigation without a mouse!
- Ctrl + K (Mac: Cmd + K): Focus epoch input field
- Ctrl + / (Mac: Cmd + /): Show keyboard shortcuts help
- Escape: Close modals/dialogs
View All Shortcuts: Press Ctrl + / (or Cmd + / on Mac) - Modal appears with visual reference
B. Accessibility Settings
Open Accessibility Panel: Click the gear icon in the header, then Accessibility settings in the Settings window
Available Options:
- Font Size Adjustment: A- and A+ buttons from 80% to 150% in steps of 10%, default 100%, applied at once
- Reduced Motion: Turn on to stop animations and transitions (fade and slide effects)
- Screen Reader Optimization: ARIA live regions announce changes, semantic HTML structure, descriptive labels on all inputs
๐ฑ Install on Your Desktop or Home Screen
Chrome, Edge and Safari can add ZeroDataUpload, the site this tool belongs to, to your desktop or home screen. It still needs an internet connection to open, and it always shows the current version.
What You Get
- An icon in your app launcher, dock or home screen
- Its own window, without the browser's address bar
- In Chrome and Edge it starts on the ZeroDataUpload homepage; Epoch Converter is in its shortcut menu (right-click or long-press the icon)
How to Install
Desktop (Chrome/Edge):
- Open the tool
- Click the install icon in the address bar (โ or โฌ), or open the browser menu and choose the option to install the site as an app
- Confirm with "Install"
- The site opens in a new window
- Access from Start Menu/Applications folder
Mobile (iOS Safari):
- Open the application
- Tap Share button (โก with arrow)
- Scroll and tap "Add to Home Screen"
- Tap "Add"
- App appears on home screen
Mobile (Android Chrome):
- Open the application
- Tap menu (โฎ)
- Select "Add to Home Screen" or "Install App"
- Tap "Add"
- App appears in app drawer
Benefits
- No Browser Clutter: Clean, focused interface
- App-like Window: No address bar or tabs
- Easy Access: Launch from dock/home screen
๐ก Tips & Tricks
Pro User Techniques
- Rapid Conversions: Press
Ctrl+Kto jump to the epoch field, and Enter after typing to submit - Batch Processing Workflow: Keep a text file of frequently used timestamps, Drag and drop for instant conversion, Export results for documentation
- Timezone Coordination: Use Multi-Timezone tool for meeting planning, Screenshot results to share with team
- Development Integration: Use Code Snippet Generator for quick reference, Copy snippets directly into your IDE, Test API responses with API Tester
- History Management: Use search to find past conversions quickly, Filter by type to see only relevant entries, Clear periodically to keep it organized
- Accessibility: Increase font size for better readability, Use reduced motion if animations distract
- Mobile Optimization: Add the site to your home screen for quick access, Use bottom navigation for thumb-friendly access
๐ Use Cases & Examples
For Developers
Scenario 1: Debug API Timestamp Issues
- Copy timestamp from API response:
1709482800 - Paste into Epoch Converter
- Verify date/time matches expected value
- Use API Tester to simulate request
Scenario 2: Generate Code Snippets
- Navigate to Tools โ Code Snippet Generator
- Select your programming language
- Copy snippet for handling timestamps
- Paste into your project
Scenario 3: Batch Convert Log Timestamps
- Export timestamps from log file
- Drag & drop into Batch Process
- Convert all to readable dates
- Export as CSV for analysis
For Project Managers
Scenario 1: Schedule International Meeting
- Pick meeting time in your timezone
- Use Multi-Timezone Comparison tool
- Check time across all team locations
- Share URL with timestamp to team
Scenario 2: Calculate Project Duration
- Navigate to Tools โ Duration Calculator
- Enter project start date
- Enter project end date (or deadline)
- View total time in various units
Scenario 3: Track Sprint Progress
- Use Countdown Timer for sprint end date
- Display on team dashboard
- Monitor days/hours remaining
For Data Analysts
Scenario 1: Convert Dataset Timestamps
- Export timestamp column from dataset
- Save as CSV or TXT file
- Import to Batch Process
- Convert all timestamps
- Export results as Excel
Scenario 2: Calculate Time Differences
- Use Timestamp Difference Calculator
- Compare event timestamps
- Identify patterns or anomalies
- Export findings
๐ Troubleshooting
Conversion shows "Invalid input"
- Check timestamp format (must be numbers only for epoch)
- Ensure date format is recognized (try ISO format: YYYY-MM-DD)
- Remove special characters or extra spaces
History not saving
- Check: Is "Auto-save to history" enabled in Settings?
- Check: Is browser in private/incognito mode? (localStorage disabled)
- Enable cookies and site data in browser settings
Theme not persisting
- Check if browser allows localStorage
- Disable private/incognito mode
- Check browser settings for site permissions
File import not working
- Check: Is file format supported? (TXT, CSV, JSON only)
- Check: Is file structure correct? (one timestamp per line for TXT)
- Try manual paste instead of file import
No install option
- Check: Are you using a supported browser? (Chrome, Edge, Safari)
- In Chrome and Edge, look in the browser menu as well as the address bar
Keyboard shortcuts not working
- Check: Are you in an input field? (Some shortcuts disabled when typing)
- Check: Is there a browser extension interfering?
- Click outside input fields first, then try shortcut
Animations too distracting
- Enable "Reduced Motion" in Accessibility settings
Text too small/large
- Use the font size buttons (A- and A+) in Accessibility settings
- Use browser zoom (Ctrl +/- or Cmd +/-)
Results not accurate
- Check: Is correct timezone selected in Settings?
- Verify timestamp unit (seconds vs milliseconds)
- Compare with another timezone converter for validation
โ FAQ (Frequently Asked Questions)
General Questions
Q: Do I need an internet connection?
A: Yes, to open the page. Once it has loaded, conversions run in your browser and need no connection.
Q: Is my data stored on a server?
A: Conversions and history stay in your browser. Share links carry their value in the URL.
Q: Can I use this on my phone?
A: Yes! The app is fully responsive and optimized for mobile devices. You can also add the site to your home screen from the browser menu.
Q: Does it work on tablets?
A: Absolutely! The responsive design adapts to all screen sizes.
Q: Is it free?
A: Yes, completely free with no sign-up or limits.
Feature Questions
Q: What's the maximum number of conversions in batch mode?
A: No hard limit, but performance may vary with very large files (10,000+ lines). Recommended max: 5,000 entries.
Q: How long is history stored?
A: Last 100 conversions are stored indefinitely (until you clear history or browser data).
Q: Can I favorite certain conversions?
A: Not currently, but you can use browser bookmarks with shareable URLs or copy to a text file.
Q: What timezones are supported?
A: 8 major timezones are built-in: Local, UTC, New York, London, Tokyo, Sydney, Dubai, Los Angeles.
Technical Questions
Q: What browsers are supported?
A: Chrome 90+, Firefox 88+, Safari 14+, Edge 90+. Modern browsers with ES6+ support.
Q: Does it require JavaScript?
A: Yes, the entire app is built with JavaScript. It won't work with JavaScript disabled.
Conversion Questions
Q: Why do some timestamps show "Invalid"?
A: Timestamps must be valid numbers within reasonable ranges (1970-2100). Dates must be parseable formats.
Q: Can I convert dates before 1970?
A: No, Unix epoch starts January 1, 1970. Dates before this aren't supported.
Q: What's the maximum date I can convert?
A: JavaScript Date objects support dates up to approximately September 13, 275760.
Q: Why does my timezone show different results?
A: Different timezones have different offsets from UTC. Ensure correct timezone is selected in Settings.
Q: What's the difference between Unix timestamp formats?
A: Seconds (10 digits), milliseconds (13 digits), microseconds (16 digits), and nanoseconds (19+ digits) represent different levels of precision.
Data & Privacy Questions
Q: Can I recover deleted history?
A: No, clearing history is permanent. Export settings periodically if you need backups.
Q: Do conversions run on a server?
A: No! Every conversion runs right here in your browser.
Q: Are my conversions visible to others?
A: Only if you share them via shareable URLs. Otherwise, everything stays on your device.
Q: What data is stored?
A: Only settings and conversion history in browser's localStorage. Neither is stored on any server.
๐ Technical Support
11.1 Contact Information
For questions, bug reports, or feature requests:
- Email: leenasoftwaresolutions@gmail.com
- Website: https://milansalvi.com/
11.2 When Reporting Issues
Please include the following information:
- Browser name and version
- Operating system
- Exact timestamp or date you're trying to convert
- Expected vs actual result
- Steps to reproduce the issue
- Screenshots if applicable
- Browser console errors (F12 > Console tab)
11.3 Response Times
- General inquiries: 24-48 hours
- Technical issues: 48-72 hours
- Critical bugs: Priority handling within 24 hours
- Feature requests: Acknowledged within 5 days
Quick Recap
โ
Core Conversions - Bidirectional epoch โ date conversion
โ
9 Advanced Tools - Timezone, duration, countdown, age, and more
โ
Batch Processing - Handle multiple conversions at once
โ
History Tracking - Search and filter past conversions
โ
Accessibility - Keyboard shortcuts, font scaling, reduced motion
โ
Mobile Support - Responsive design, add to your home screen
โ
Developer Tools - Code snippets, cron parser, ISO 8601 parser
Best Practices
- Add it to your home screen for quick access
- Enable auto-save to build conversion history
- Use keyboard shortcuts for efficiency
- Adjust accessibility settings to your needs
- Export settings periodically for backup
- Explore all 9 tools to find what fits your workflow
Privacy: All timestamp conversions happen locally in your browser. Your data is never uploaded to servers.
Performance: Instant client-side processing with pure JavaScript for accurate timestamp calculations.
Thank you for using Epoch Converter Pro - the Unix timestamp converter on ZeroDataUpload.
Last Updated: October 3, 2025
Contact: leenasoftwaresolutions@gmail.com
Website: https://milansalvi.com/