Endpoints

https://api.sinaty.business/time/

curl "https://api.sinaty.business/time/?timezone=America/New_York"

curl "https://api.sinaty.business/time/?operation=difference&start=2024-01-01&end=2024-01-15"

curl "https://api.sinaty.business/time/?operation=add&datetime=2024-01-01&amount=7&unit=days"

curl "https://api.sinaty.business/time/?operation=convert_timezone&datetime=2024-01-15T10:30:00&from_timezone=America/New_York&to_timezone=Europe/London"

{
    "operation": "current",
    "timestamp": 1705312200,
    "datetime": "2024-01-15 10:30:00",
    "date": "2024-01-15",
    "time": "10:30:00",
    "timezone": "America/New_York",
    "unix_timestamp": 1705312200,
    "iso8601": "2024-01-15T10:30:00-05:00",
    "rfc2822": "Mon, 15 Jan 2024 10:30:00 -0500",
    "year": "2024",
    "month": "01",
    "day": "15",
    "hour": "10",
    "minute": "30",
    "second": "00",
    "day_of_week": "Monday",
    "day_of_year": "14",
    "week_of_year": "03",
    "is_leap_year": true,
    "timezone_offset": "-05:00"
}

{
    "operation": "difference",
    "start": "2024-01-01T00:00:00Z",
    "end": "2024-01-15T00:00:00Z",
    "difference": {
        "total_seconds": 1209600,
        "total_minutes": 20160,
        "total_hours": 336,
        "total_days": 14,
        "total_weeks": 2,
        "formatted": "14 days, 0 hours, 0 minutes"
    }
}

{
    "operation": "convert_timezone",
    "original_datetime": "2024-01-15T10:30:00",
    "from_timezone": "America/New_York",
    "to_timezone": "Europe/London",
    "converted_datetime": "2024-01-15T15:30:00",
    "converted_date": "2024-01-15",
    "converted_time": "15:30:00",
    "timezone_offset": "+00:00"
}

{
    "operation": "add",
    "datetime": "2024-01-01",
    "amount": 7,
    "unit": "days"
}

curl -X POST "https://api.sinaty.business/time/" \
  -H "Content-Type: application/json" \
  -d '{"operation": "difference", "start": "2024-01-01", "end": "2024-01-15"}'

{
    "error": "Missing required parameters",
    "details": "Operation 'difference' requires 'start' and 'end' parameters"
}

{
    "error": "Invalid datetime format",
    "details": "Unable to parse datetime: 'invalid-date'"
}

{
    "error": "Invalid timezone",
    "details": "Timezone 'Invalid/Timezone' not found"
}

{
    "error": "Invalid time unit",
    "details": "Supported units: seconds, minutes, hours, days, weeks, months, years"
}

# Good - Use specific timezone
curl "https://api.sinaty.business/time/?timezone=America/New_York"

# Avoid - Relying on server timezone
curl "https://api.sinaty.business/time/"

# Good - Use ISO format for precision
curl "https://api.sinaty.business/time/?operation=difference&start=2024-01-01T00:00:00Z&end=2024-01-15T00:00:00Z"

# Good - Use natural language for relative dates
curl "https://api.sinaty.business/time/?operation=add&datetime=today&amount=7&unit=days"

async function getCurrentTime(timezone = 'UTC') {
    try {
        const response = await fetch(
            `https://api.sinaty.business/time/?timezone=${encodeURIComponent(timezone)}`
        );
        
        if (!response.ok) {
            const error = await response.json();
            console.error('API Error:', error.error);
            console.error('Details:', error.details);
            return null;
        }
        
        const data = await response.json();
        return data;
    } catch (error) {
        console.error('Request failed:', error);
        return null;
    }
}

async function scheduleMeeting(startTime, duration, timezone) {
    const start = await getCurrentTime(timezone);
    const end = await addTime(start.datetime, duration, 'minutes');
    
    return {
        start: start.datetime,
        end: end.datetime,
        timezone: timezone
    };
}

async function calculateDeadline(daysFromNow) {
    const result = await fetch(
        `https://api.sinaty.business/time/?operation=add&datetime=today&amount=${daysFromNow}&unit=days`
    );
    const data = await result.json();
    return data.datetime;
}

async function convertMeetingTime(meetingTime, fromTimezone, toTimezone) {
    const result = await fetch(
        `https://api.sinaty.business/time/?operation=convert_timezone&datetime=${meetingTime}&from_timezone=${fromTimezone}&to_timezone=${toTimezone}`
    );
    const data = await result.json();
    return data.converted_datetime;
}

const timezoneCache = new Map();

async function getTimezoneInfo(timezone) {
    if (timezoneCache.has(timezone)) {
        return timezoneCache.get(timezone);
    }
    
    const result = await fetch(
        `https://api.sinaty.business/time/?operation=timezone_info&timezone=${timezone}`
    );
    const data = await result.json();
    
    timezoneCache.set(timezone, data);
    return data;
}

async function processMultipleTimes(operations) {
    const response = await fetch('https://api.sinaty.business/time/', {
        method: 'POST',
        headers: { 'Content-Type': 'application/json' },
        body: JSON.stringify(operations)
    });
    
    return await response.json();
}