| Name | sometime JSON |
| Version |
1.2.2
JSON |
| download |
| home_page | |
| Summary | Get timestamp, formatted date, and perform date/time operations. |
| upload_time | 2023-01-23 17:59:12 |
| maintainer | |
| docs_url | None |
| author | Rodney Maniego Jr. |
| requires_python | >=3.10 |
| license | LICENSE.txt |
| keywords |
date
time
timestamp
utc
|
| VCS |
|
| bugtrack_url |
|
| requirements |
No requirements were recorded.
|
| Travis-CI |
No Travis.
|
| coveralls test coverage |
No coveralls.
|
# sometime
Get timestamp, formatted date, and perform date/time operations.
## Official Release
**Sometime** v1.2.0
`pip install sometime -U`
## Basic Usage
```python
from sometime import Sometime
```
```python
# Default initialization
ts = Sometime()
# Custom initialization
ts = Sometime(1650614778, utc=True)
# Set timestamp in seconds
ts.timestamp(seconds)
ts["timestamp"] = seconds
# Set date/time based on date/time string
# https://help.gnome.org/users/gthumb/stable/gthumb-date-formats.html.en"
ts.from_iso("2022-04-22", "%Y-%m-%d")
print("Timestamp:", ts.timestamp())
```
# Get Unix Timestamp
```python
print("Timestamp:", ts.timestamp())
```
# Get current Unix Timestamp
```python
print("Current Timestamp:", ts.now())
```
# Add or subtract years
```python
ts = Sometime(seconds)
ts.year(years=-25)
ts.year(years=100)
print("Year:", ts.year())
print("Year:", ts["%Y"])
```
# Get name of the month
```python
ts = Sometime(seconds)
ts.name_of_month()
print("Date of the Month:", ts.name_of_month())
```
# Add or subtract months
```python
ts = Sometime(seconds)
ts.month(months=-1)
ts.month(months=12)
print("Month:", ts.month())
```
# Add or subtract days
```python
ts = Sometime(seconds)
ts.day(days=-7)
ts.day(days=14)
print("Day:", ts.day())
```
# Add or subtract hours
```python
ts = Sometime(seconds)
ts.hour(hours=-8)
ts.hour(hours=24)
hour = ts.hour()
print("Hour:", ts.hour())
```
# Add or subtract minutes
```python
ts = Sometime(seconds)
ts.minute(minutes=-5)
ts.minute(minutes=30)
minute = ts.minute()
print("Minute:", ts.minute())
```
# Add or subtract seconds
```python
ts = Sometime(seconds)
ts.second(seconds=-1)
ts.second(seconds=30)
second = ts.second()
print("Second:", ts.second())
```
# Get if AM/PM
```python
ts = Sometime(seconds)
ts.period()
print("Period:", ts.period())
```
# Get the Day of the Week
```python
ts = Sometime(seconds)
print("Day of the Week:", ts.day_of_week())
```
# Add or subtract to date/time
```python
ts = Sometime(seconds)
print("Timestamp:", ts.timestamp())
ts.add(years=1, months=2, days=3, hours=4, minutes=5, seconds=6)
print("Timestamp:", ts.timestamp())
```
# Format date/time into string representation
```python
ts = Sometime(seconds)
print("Timestamp:", ts.custom("%Y-%m-%d %H:%M:%S %p"))
```
# Get yesterday's on custom formatting
```python
ts = Sometime(seconds)
print("Yesterday:", ts.yesterday("%Y-%m-%d %H:%M:%S %p"))
```
Raw data
{
"_id": null,
"home_page": "",
"name": "sometime",
"maintainer": "",
"docs_url": null,
"requires_python": ">=3.10",
"maintainer_email": "",
"keywords": "date,time,timestamp,utc",
"author": "Rodney Maniego Jr.",
"author_email": "rodney.maniegojr@gmail.com",
"download_url": "https://files.pythonhosted.org/packages/93/3c/49f636b7856cf2d90c429e5d838f64feaa609e4cf4a9f5b8edf71674ddbc/sometime-1.2.2.tar.gz",
"platform": null,
"description": "# sometime\nGet timestamp, formatted date, and perform date/time operations.\n\n## Official Release\n**Sometime** v1.2.0\n\n`pip install sometime -U`\n\n## Basic Usage\n\n```python\nfrom sometime import Sometime\n```\n\n```python\n# Default initialization\nts = Sometime()\n\n# Custom initialization\nts = Sometime(1650614778, utc=True)\n\n# Set timestamp in seconds\nts.timestamp(seconds)\nts[\"timestamp\"] = seconds\n\n# Set date/time based on date/time string\n# https://help.gnome.org/users/gthumb/stable/gthumb-date-formats.html.en\"\nts.from_iso(\"2022-04-22\", \"%Y-%m-%d\")\nprint(\"Timestamp:\", ts.timestamp())\n```\n\n# Get Unix Timestamp\n```python\nprint(\"Timestamp:\", ts.timestamp())\n```\n\n# Get current Unix Timestamp\n```python\nprint(\"Current Timestamp:\", ts.now())\n```\n\n# Add or subtract years\n```python\nts = Sometime(seconds)\nts.year(years=-25)\nts.year(years=100)\nprint(\"Year:\", ts.year())\nprint(\"Year:\", ts[\"%Y\"])\n```\n\n# Get name of the month\n```python\nts = Sometime(seconds)\nts.name_of_month()\nprint(\"Date of the Month:\", ts.name_of_month())\n```\n\n# Add or subtract months\n```python\nts = Sometime(seconds)\nts.month(months=-1)\nts.month(months=12)\nprint(\"Month:\", ts.month())\n```\n\n# Add or subtract days\n```python\nts = Sometime(seconds)\nts.day(days=-7)\nts.day(days=14)\nprint(\"Day:\", ts.day())\n```\n\n# Add or subtract hours\n```python\nts = Sometime(seconds)\nts.hour(hours=-8)\nts.hour(hours=24)\nhour = ts.hour()\nprint(\"Hour:\", ts.hour())\n```\n\n# Add or subtract minutes\n```python\nts = Sometime(seconds)\nts.minute(minutes=-5)\nts.minute(minutes=30)\nminute = ts.minute()\nprint(\"Minute:\", ts.minute())\n```\n\n# Add or subtract seconds\n```python\nts = Sometime(seconds)\nts.second(seconds=-1)\nts.second(seconds=30)\nsecond = ts.second()\nprint(\"Second:\", ts.second())\n```\n\n# Get if AM/PM\n```python\nts = Sometime(seconds)\nts.period()\nprint(\"Period:\", ts.period())\n```\n\n# Get the Day of the Week\n```python\nts = Sometime(seconds)\nprint(\"Day of the Week:\", ts.day_of_week())\n```\n\n# Add or subtract to date/time\n```python\nts = Sometime(seconds)\nprint(\"Timestamp:\", ts.timestamp())\nts.add(years=1, months=2, days=3, hours=4, minutes=5, seconds=6)\nprint(\"Timestamp:\", ts.timestamp())\n```\n\n# Format date/time into string representation\n```python\nts = Sometime(seconds)\nprint(\"Timestamp:\", ts.custom(\"%Y-%m-%d %H:%M:%S %p\"))\n```\n\n# Get yesterday's on custom formatting\n```python\nts = Sometime(seconds)\nprint(\"Yesterday:\", ts.yesterday(\"%Y-%m-%d %H:%M:%S %p\"))\n```\n",
"bugtrack_url": null,
"license": "LICENSE.txt",
"summary": "Get timestamp, formatted date, and perform date/time operations.",
"version": "1.2.2",
"split_keywords": [
"date",
"time",
"timestamp",
"utc"
],
"urls": [
{
"comment_text": "",
"digests": {
"blake2b_256": "76eeb0c9cefe512190caecd99aab9296cb337670b604ea670f8bbeb21896bd98",
"md5": "6b8a5f4fc467ca3b676ec8c21906c53b",
"sha256": "f6a19431b62df6c7320fe01589571a96e86c95f9073e508c17d0bf759b9797e6"
},
"downloads": -1,
"filename": "sometime-1.2.2-py3-none-any.whl",
"has_sig": false,
"md5_digest": "6b8a5f4fc467ca3b676ec8c21906c53b",
"packagetype": "bdist_wheel",
"python_version": "py3",
"requires_python": ">=3.10",
"size": 4061,
"upload_time": "2023-01-23T17:59:11",
"upload_time_iso_8601": "2023-01-23T17:59:11.202273Z",
"url": "https://files.pythonhosted.org/packages/76/ee/b0c9cefe512190caecd99aab9296cb337670b604ea670f8bbeb21896bd98/sometime-1.2.2-py3-none-any.whl",
"yanked": false,
"yanked_reason": null
},
{
"comment_text": "",
"digests": {
"blake2b_256": "933c49f636b7856cf2d90c429e5d838f64feaa609e4cf4a9f5b8edf71674ddbc",
"md5": "657efc8b3067f8ed305cc11ccd80de82",
"sha256": "52e3869ca3aa31e1566e65058992bd8cca66fd3cb416f052b6761acea6b0fc15"
},
"downloads": -1,
"filename": "sometime-1.2.2.tar.gz",
"has_sig": false,
"md5_digest": "657efc8b3067f8ed305cc11ccd80de82",
"packagetype": "sdist",
"python_version": "source",
"requires_python": ">=3.10",
"size": 3444,
"upload_time": "2023-01-23T17:59:12",
"upload_time_iso_8601": "2023-01-23T17:59:12.743909Z",
"url": "https://files.pythonhosted.org/packages/93/3c/49f636b7856cf2d90c429e5d838f64feaa609e4cf4a9f5b8edf71674ddbc/sometime-1.2.2.tar.gz",
"yanked": false,
"yanked_reason": null
}
],
"upload_time": "2023-01-23 17:59:12",
"github": false,
"gitlab": false,
"bitbucket": false,
"lcname": "sometime"
}
