get_current_date_info
Retrieve current date and time details including year, month, day, timestamp, and formatting options for system integration.
Instructions
Get comprehensive information about the current date.
Returns:
DateInfo: A dictionary containing comprehensive date and time information:
- full_datetime (str): Full date and time in YYYY-MM-DD HH:MM:SS format
- iso_date (str): ISO 8601 date format (YYYY-MM-DD)
- iso_datetime (str): ISO 8601 datetime format with timezone
- timestamp (int): Unix timestamp (seconds since epoch)
- year (int): Current year (e.g., 2024)
- month (int): Current month (1-12)
- day (int): Current day of the month (1-31)
- day_of_year (int): Day number in the year (1-366)
- day_of_week_number (int): Day of the week (0=Monday, 6=Sunday)
- day_name (str): Full name of the day (e.g., "Monday")
- day_name_short (str): Short name of the day (e.g., "Mon")
- month_name (str): Full name of the month (e.g., "January")
- month_name_short (str): Short name of the month (e.g., "Jan")
- is_leap_year (bool): True if current year is a leap year
- week_number (int): ISO 8601 week number (1-53)
- iso_year (int): ISO 8601 year (may differ from calendar year)
- weekday_iso (int): ISO weekday (1=Monday, 7=Sunday)
- quarter (int): Quarter of the year (1-4)
- days_in_month (int): Total days in the current month
- hour (int): Current hour (0-23)
- minute (int): Current minute (0-59)
- second (int): Current second (0-59)
- microsecond (int): Current microsecond (0-999999)Input Schema
TableJSON Schema
| Name | Required | Description | Default |
|---|---|---|---|
No arguments | |||
Implementation Reference
- src/server.py:95-194 (handler)The @mcp.tool decorated function implementing the get_current_date_info tool. It computes comprehensive current date and time information using datetime and calendar modules, populates a DateInfo model, and returns it. This serves as both the handler logic and registration via FastMCP decorator.
@mcp.tool(annotations=ToolAnnotations(readOnlyHint=True)) def get_current_date_info() -> DateInfo: """ Get comprehensive information about the current date. Returns: DateInfo: A dictionary containing comprehensive date and time information: - full_datetime (str): Full date and time in YYYY-MM-DD HH:MM:SS format - iso_date (str): ISO 8601 date format (YYYY-MM-DD) - iso_datetime (str): ISO 8601 datetime format with timezone - timestamp (int): Unix timestamp (seconds since epoch) - year (int): Current year (e.g., 2024) - month (int): Current month (1-12) - day (int): Current day of the month (1-31) - day_of_year (int): Day number in the year (1-366) - day_of_week_number (int): Day of the week (0=Monday, 6=Sunday) - day_name (str): Full name of the day (e.g., "Monday") - day_name_short (str): Short name of the day (e.g., "Mon") - month_name (str): Full name of the month (e.g., "January") - month_name_short (str): Short name of the month (e.g., "Jan") - is_leap_year (bool): True if current year is a leap year - week_number (int): ISO 8601 week number (1-53) - iso_year (int): ISO 8601 year (may differ from calendar year) - weekday_iso (int): ISO weekday (1=Monday, 7=Sunday) - quarter (int): Quarter of the year (1-4) - days_in_month (int): Total days in the current month - hour (int): Current hour (0-23) - minute (int): Current minute (0-59) - second (int): Current second (0-59) - microsecond (int): Current microsecond (0-999999) """ now = datetime.now() current_date = now.date() # Basic date information day = current_date.day month = current_date.month year = current_date.year # Day of the year (1-366) day_of_year = current_date.timetuple().tm_yday # Day of the week (0=Monday, 6=Sunday) day_of_week_number = current_date.weekday() # Day names day_name_english = current_date.strftime("%A") day_name_short_english = current_date.strftime("%a") # Month names month_name_english = current_date.strftime("%B") month_name_short_english = current_date.strftime("%b") # Check if leap year is_leap_year = calendar.isleap(year) # Week number (ISO 8601) year_iso, week_number, weekday_iso = current_date.isocalendar() # Days in current month days_in_month = calendar.monthrange(year, month)[1] # Quarter quarter = (month - 1) // 3 + 1 # Full datetime string full_datetime = now.strftime("%Y-%m-%d %H:%M:%S") # ISO format iso_date = current_date.isoformat() iso_datetime = now.isoformat() # Timestamp timestamp = int(now.timestamp()) return DateInfo( full_datetime=full_datetime, iso_date=iso_date, iso_datetime=iso_datetime, timestamp=timestamp, year=year, month=month, day=day, day_of_year=day_of_year, day_of_week_number=day_of_week_number, day_name=day_name_english, day_name_short=day_name_short_english, month_name=month_name_english, month_name_short=month_name_short_english, is_leap_year=is_leap_year, week_number=week_number, iso_year=year_iso, weekday_iso=weekday_iso, quarter=quarter, days_in_month=days_in_month, hour=now.hour, minute=now.minute, second=now.second, microsecond=now.microsecond, ) - src/models.py:4-29 (schema)Pydantic BaseModel defining the DateInfo output schema for the get_current_date_info tool, including fields like full_datetime, year, month, day_of_week, etc.
class DateInfo(BaseModel): """Type definition for date information returned by get_current_date_info.""" full_datetime: str iso_date: str iso_datetime: str timestamp: int year: int month: int day: int day_of_year: int day_of_week_number: int day_name: str day_name_short: str month_name: str month_name_short: str is_leap_year: bool week_number: int iso_year: int weekday_iso: int quarter: int days_in_month: int hour: int minute: int second: int microsecond: int