Formatting Date

The API server expects the input datetime to be in ISO 8601 format, including the timezone.

When Z is used as the timezone specifier, it represents GMT (UTC). If the actual time falls within a different timezone, using Z may lead to incorrect results. For example, to accurately represent the birth time of a user born at midnight in India on August 15, 1947, the correct ISO 8601 representation would be 1947-08-15T00:00:00+05:30 (Indian Standard Time).

When the date is used as a URL parameter, it should be URL-encoded. In particular, the + symbol (used in the timezone offset) must be replaced with %2B. For example, the above date and time should be encoded as 1947-08-15T00:00:00%2B05:30.

This documentation provides examples for formatting specific dates and times in ISO 8601 format in popular programming languages.

PHP

To create a date with a specific timezone like Asia/Kolkata, you can use the DateTimeImmutable class along with the DateTimeZone class in PHP.

$year = 1947;
$month = 8;
$day = 15;
$hour = 0;
$min = 0;
$sec = 0;

$timezone = new \DateTimeZone('Asia/Kolkata');
$date = new \DateTimeImmutable("$year-$month-$day $hour:$min:$sec", $timezone);
echo $date->format(DateTime::ATOM);

JavaScript

In JavaScript, you can use the Date object along with the toISOString() method for formatting the date in ISO 8601. However, the Date object will only output in UTC. To work with specific timezones, you can use libraries like luxon or date-fns-tz.

// Using the luxon library for timezone support
const { DateTime } = require("luxon");

const date = DateTime.fromObject({
  year: 1947,
  month: 8,
  day: 15,
  hour: 0,
  minute: 0,
  second: 0,
}, { zone: 'Asia/Kolkata' });

console.log(date.toISO());

Python

Python's datetime module supports timezone handling through pytz.

from datetime import datetime
import pytz

timezone = pytz.timezone('Asia/Kolkata')
date = datetime(1947, 8, 15, 0, 0, 0)
date = timezone.localize(date)

print(date.isoformat())

Go

In Go, you can use the time package to create dates with specific timezones.

package main

import (
    "fmt"
    "time"
)

func main() {
    loc, _ := time.LoadLocation("Asia/Kolkata")
    date := time.Date(1947, 8, 15, 0, 0, 0, 0, loc)
    fmt.Println(date.Format(time.RFC3339))
}

Java

In Java, you can use the ZonedDateTime class with the ZoneId class to specify a timezone.

import java.time.ZonedDateTime;
import java.time.ZoneId;
import java.time.format.DateTimeFormatter;

public class Main {
    public static void main(String[] args) {
        ZonedDateTime date = ZonedDateTime.of(1947, 8, 15, 0, 0, 0, 0, ZoneId.of("Asia/Kolkata"));
        System.out.println(date.format(DateTimeFormatter.ISO_ZONED_DATE_TIME));
    }
}

Ruby

Ruby's Time class can be used with timezones through the TZInfo gem.

require 'time'
require 'tzinfo'

timezone = TZInfo::Timezone.get('Asia/Kolkata')
date = timezone.local_time(1947, 8, 15, 0, 0, 0)

puts date.iso8601

Rust

In Rust, you can use the chrono crate along with chrono-tz to work with timezones.

use chrono::NaiveDate;
use chrono::TimeZone;
use chrono_tz::Tz;

fn main() {
    // Use the 'Asia/Kolkata' timezone
    let timezone: Tz = "Asia/Kolkata".parse().unwrap();
    
    // Create the date and time
    let naive_date = NaiveDate::from_ymd(1947, 8, 15).and_hms(0, 0, 0);
    
    // Convert the naive date to the specific timezone
    let date_with_timezone = timezone.from_local_datetime(&naive_date).unwrap();

    // Print the date in RFC3339 format (ISO 8601)
    println!("{}", date_with_timezone.to_rfc3339()); // Output: 1947-08-15T00:00:00+05:30
}

Swift

In Swift, you can use DateFormatter and TimeZone to create a date with a specific timezone.

import Foundation

let formatter = DateFormatter()
formatter.dateFormat = "yyyy-MM-dd'T'HH:mm:ssZ"
formatter.timeZone = TimeZone(identifier: "Asia/Kolkata")

if let date = formatter.date(from: "1947-08-15T00:00:00+0530") {
    print(formatter.string(from: date))
}

These examples show how to handle datetime creation and formatting in different programming languages when working with specific timezones. Ensure that the timezone is correctly applied before sending the date to the API to avoid unexpected results.