feat: date generator functions

[mathnogueira]

This PR adds support for two new generator functions: date() and dateTime().

Motivation

This was asked by a user in our discord channel

About the functions

// returns the date in the time.DateOnly format (YYYY-MM-DD)
// if format is provided, it will be formatted based on it.
date(format optional<string>)

// returns the date and time in the time.RFC3339 format (2006-01-02T15:04:05Z07:00)
// if format is provided, it will be formatted based on it.
dateTime(format optional<string>)

Examples

date() : 2023-11-01
date("MM-DD-YYYY") : 11-01-2023
date("DD/MM/YYYY") : 01/11/2023
dateTime() : 2023-11-01T12:38:12Z03:00
dateTime("hh:mm:ss") : 12:38:12

Checklist

• tested locally
• added new dependencies
• updated the docs
• added a test

Loom video

Add your loom video here if your work can be visualized

[mathnogueira]

This library uses the time.Format function to format dates but it allows us to use the W3C format instead of go's magic numbers:

DD/MM/YYYY instead of 02/01/2006

[jfermi]

Some editing suggestions.