Cloudmersive Date Time API

Date Time operations of the Cloudmersive Validate API — 4 operation(s) served from https://api.cloudmersive.com and authenticated with the Apikey header. One Cloudmersive API key grants access to every API in the portfolio.

Operations 4

GET /validate/date-time/get/now Get current date and time as of now #
POST /validate/date-time/get/holidays Get public holidays in the specified country and year #
POST /validate/date-time/parse/date-time/structured Parses a standardized date and time string into a date and time #
POST /validate/date-time/parse/date-time/natural-language Parses a free-form natural language date and time string into a date and time #

Work with this as data

Every API here is available over the APIs.io API and to AI agents over MCP.

MCP server

One button, every client — Claude, Cursor, VS Code and the rest.

https://apis.io/mcp

Tools for apis

7 MCP tools reach this
  • find_apisBrowse and filter every API in the catalog.
  • get_api_artifactsOne API's artifacts, grouped by type.
  • get_openapiThe primary OpenAPI for this API.
  • find_similar_apisAPIs that look like this one.
  • apis_io_searchSTART HERE — APIs, providers and tags for one query, each with its total.
  • resolveTurn a domain, URL or GitHub org into the provider it belongs to.
  • find_cohortsEvery scored population of providers in the catalog.
All 92 tools →

Call it yourself

curl for this page
This API
curl "https://apis.io/api/v1/apis/cloudmersive:cloudmersive-datetime-api"
All apis
curl "https://apis.io/api/v1/apis?limit=25"

Calls without X-API-Key need no key. Calls with it need a paid plan — get a key.

Get an API key

Free tier, no form to fill in. Signing in shares your email address with us — we store it to create your key and to recognise you if you sign in with another provider. See our Privacy Policy and Terms.

A second provider on the same verified email joins the account you already have.

OpenAPI Specification

cloudmersive-datetime-api-openapi.yml Raw ↑
openapi: 3.2.0
info:
  version: v1
  title: validateapi Date Time API
  description: The validation APIs help you validate data. Check if an E-mail address is real. Check if a domain is real. Check up on an IP address, and even where it is located. All this and much more is available in the validation API.
servers:
- url: http://localhost
tags:
- name: DateTime
paths:
  /validate/date-time/get/now:
    get:
      tags:
      - DateTime
      summary: Get current date and time as of now
      description: Gets the current date and time. Response time is syncronized with atomic clocks, and represents a monotonic, centrally available, consistent clock.
      operationId: DateTime_GetNowSimple
      responses:
        '200':
          description: OK
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/DateTimeNowResult'
            text/json:
              schema:
                $ref: '#/components/schemas/DateTimeNowResult'
            application/xml:
              schema:
                $ref: '#/components/schemas/DateTimeNowResult'
            text/xml:
              schema:
                $ref: '#/components/schemas/DateTimeNowResult'
      security:
      - Apikey: []
  /validate/date-time/get/holidays:
    post:
      tags:
      - DateTime
      summary: Get public holidays in the specified country and year
      description: Enumerates all public holidays in a given country for a given year. Supports over 100 countries.
      operationId: DateTime_GetPublicHolidays
      responses:
        '200':
          description: OK
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/PublicHolidaysResponse'
            text/json:
              schema:
                $ref: '#/components/schemas/PublicHolidaysResponse'
            application/xml:
              schema:
                $ref: '#/components/schemas/PublicHolidaysResponse'
            text/xml:
              schema:
                $ref: '#/components/schemas/PublicHolidaysResponse'
      security:
      - Apikey: []
      requestBody:
        content:
          application/json:
            schema:
              $ref: '#/components/schemas/GetPublicHolidaysRequest'
          text/json:
            schema:
              $ref: '#/components/schemas/GetPublicHolidaysRequest'
        description: Input request
        required: true
  /validate/date-time/parse/date-time/structured:
    post:
      tags:
      - DateTime
      summary: Parses a standardized date and time string into a date and time
      description: Parses a structured date and time string into a date time object. This is intended for standardized date strings that adhere to formatting conventions, rather than natural language input.
      operationId: DateTime_ParseStandardDateTime
      responses:
        '200':
          description: OK
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/DateTimeStandardizedParseResponse'
            text/json:
              schema:
                $ref: '#/components/schemas/DateTimeStandardizedParseResponse'
            application/xml:
              schema:
                $ref: '#/components/schemas/DateTimeStandardizedParseResponse'
            text/xml:
              schema:
                $ref: '#/components/schemas/DateTimeStandardizedParseResponse'
      security:
      - Apikey: []
      requestBody:
        content:
          application/json:
            schema:
              $ref: '#/components/schemas/DateTimeStandardizedParseRequest'
          text/json:
            schema:
              $ref: '#/components/schemas/DateTimeStandardizedParseRequest'
        description: Input request
        required: true
  /validate/date-time/parse/date-time/natural-language:
    post:
      tags:
      - DateTime
      summary: Parses a free-form natural language date and time string into a date and time
      description: Parses an unstructured, free-form, natural language date and time string into a date time object. This is intended for lightweight human-entered input, such as "tomorrow at 3pm" or "tuesday".
      operationId: DateTime_ParseNaturalLanguageDateTime
      responses:
        '200':
          description: OK
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/DateTimeStandardizedParseResponse'
            text/json:
              schema:
                $ref: '#/components/schemas/DateTimeStandardizedParseResponse'
            application/xml:
              schema:
                $ref: '#/components/schemas/DateTimeStandardizedParseResponse'
            text/xml:
              schema:
                $ref: '#/components/schemas/DateTimeStandardizedParseResponse'
      security:
      - Apikey: []
      requestBody:
        content:
          application/json:
            schema:
              $ref: '#/components/schemas/DateTimeNaturalLanguageParseRequest'
          text/json:
            schema:
              $ref: '#/components/schemas/DateTimeNaturalLanguageParseRequest'
        description: Input request
        required: true
components:
  schemas:
    PublicHolidayOccurrence:
      description: Public holiday occurrence
      type: object
      properties:
        EnglishName:
          description: Name of the holiday in English
          type: string
        LocalName:
          description: Local name of the holiday
          type: string
        OccurrenceDate:
          format: date-time
          description: Date of the holiday (start time)
          type: string
        HolidayType:
          description: 'Type of the holiday; possible values are: Public, Optional'
          type: string
        Nationwide:
          description: True if the holiday is celebrated in all locales in the country, false otherwise
          type: boolean
    GetPublicHolidaysRequest:
      description: Input parameter to a country validation request
      type: object
      properties:
        RawCountryInput:
          description: Two-letter code (FIPS 10-4 or ISO 3166-1) of the country; if not specified, defaults to United States
          type: string
        Year:
          format: int32
          description: Optional - the year in which to retrieve the holidays; if left blank (0) it will default to the current year
          type: integer
    DateTimeNaturalLanguageParseRequest:
      description: Input parameter to a date time parsing request
      type: object
      properties:
        RawDateTimeInput:
          description: Raw string input of a natural language-formatted date and time for parsing
          type: string
    DateTimeStandardizedParseResponse:
      description: Result of performing a date time parsing
      type: object
      properties:
        Successful:
          description: True if successful, false otherwise
          type: boolean
        ParsedDateResult:
          format: date-time
          description: Result of performing a date time parsing
          type: string
        Year:
          format: int32
          description: Year of the parsed date time result
          type: integer
        Month:
          format: int32
          description: Month of the parsed date time result
          type: integer
        Day:
          format: int32
          description: Day of the parsed date time result
          type: integer
        Hour:
          format: int32
          description: Hour of the parsed date time result (24-hour)
          type: integer
        Minute:
          format: int32
          description: Minute of the parsed date time result
          type: integer
        Second:
          format: int32
          description: Second of the parsed date time result
          type: integer
        DayOfWeek:
          description: Day of week
          type: string
    PublicHolidaysResponse:
      description: Result of performing a get public holidays request operation
      type: object
      properties:
        Successful:
          description: True if successful, false otherwise
          type: boolean
        PublicHolidays:
          description: Public holidays in the requested country and year
          type: array
          items:
            $ref: '#/components/schemas/PublicHolidayOccurrence'
    DateTimeNowResult:
      description: Current date and time response
      type: object
      properties:
        Successful:
          description: True if successful, false otherwise
          type: boolean
        Now:
          format: date-time
          description: Current date, time, and time zone in standard JSON date format
          type: string
        NowGmt:
          format: date-time
          description: Current GMT-time-zone date, time, and time zone in standard JSON date format
          type: string
    DateTimeStandardizedParseRequest:
      description: Input parameter to a date time parsing request
      type: object
      properties:
        RawDateTimeInput:
          description: Raw string input of a standard-formatted date and time for parsing
          type: string
        CountryCode:
          description: 'Optional: specify the two-letter country code to optimzie date formatting; default is US'
          type: string
  securitySchemes:
    Apikey:
      type: apiKey
      description: API Key Authentication
      name: Apikey
      in: header
x-provenance:
  method: harvested
  publisher: Cloudmersive
  source: https://api.cloudmersive.com/validate/docs/v1/swagger
  note: split by refine-openapis from the provider's own published document, verified by fetch (openapi/_original/*.fetch.json);
    stamped by stamp-openapi-provenance.py (roadmap#793)