{"id":15672274,"url":"https://github.com/mrxiaom/timeoperate-expansion","last_synced_at":"2026-01-04T16:16:40.996Z","repository":{"id":65665655,"uuid":"596853349","full_name":"MrXiaoM/TimeOperate-Expansion","owner":"MrXiaoM","description":"Time operating expansion for PlaceholderAPI","archived":false,"fork":false,"pushed_at":"2025-01-11T12:09:41.000Z","size":80,"stargazers_count":4,"open_issues_count":0,"forks_count":0,"subscribers_count":1,"default_branch":"main","last_synced_at":"2025-05-06T21:08:35.329Z","etag":null,"topics":["java","minecraft","placeholderapi","placeholders","spigot"],"latest_commit_sha":null,"homepage":"","language":"Java","has_issues":true,"has_wiki":null,"has_pages":null,"mirror_url":null,"source_name":null,"license":"mit","status":null,"scm":"git","pull_requests_enabled":true,"icon_url":"https://github.com/MrXiaoM.png","metadata":{"files":{"readme":"README.md","changelog":null,"contributing":null,"funding":null,"license":"LICENSE","code_of_conduct":null,"threat_model":null,"audit":null,"citation":null,"codeowners":null,"security":null,"support":null,"governance":null,"roadmap":null,"authors":null,"dei":null,"publiccode":null,"codemeta":null}},"created_at":"2023-02-03T04:04:05.000Z","updated_at":"2025-01-11T12:08:40.000Z","dependencies_parsed_at":"2024-08-14T07:24:13.898Z","dependency_job_id":"1a57da26-c1c7-42f3-8f0f-68402906e681","html_url":"https://github.com/MrXiaoM/TimeOperate-Expansion","commit_stats":null,"previous_names":[],"tags_count":6,"template":false,"template_full_name":null,"repository_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/MrXiaoM%2FTimeOperate-Expansion","tags_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/MrXiaoM%2FTimeOperate-Expansion/tags","releases_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/MrXiaoM%2FTimeOperate-Expansion/releases","manifests_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/MrXiaoM%2FTimeOperate-Expansion/manifests","owner_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners/MrXiaoM","download_url":"https://codeload.github.com/MrXiaoM/TimeOperate-Expansion/tar.gz/refs/heads/main","host":{"name":"GitHub","url":"https://github.com","kind":"github","repositories_count":252769421,"owners_count":21801378,"icon_url":"https://github.com/github.png","version":null,"created_at":"2022-05-30T11:31:42.601Z","updated_at":"2022-07-04T15:15:14.044Z","host_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub","repositories_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories","repository_names_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repository_names","owners_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners"}},"keywords":["java","minecraft","placeholderapi","placeholders","spigot"],"created_at":"2024-10-03T15:22:58.250Z","updated_at":"2026-01-04T16:16:40.990Z","avatar_url":"https://github.com/MrXiaoM.png","language":"Java","funding_links":[],"categories":[],"sub_categories":[],"readme":"# TimeOperate-Expansion\nTime operating expansion for PlaceholderAPI\n\n# Install\n\n* Download jar file from [releases](https://github.com/MrXiaoM/TimeOperate-Expansion/releases).\n* Put the jar file to `/plugins/PlaceholderAPI/expansions/`\n* Execute command `/papi register \u003cfilename\u003e` or `/papi reload` or restart server.\n\n# Usage\n\n```\n// Arguments: \u003cRequired\u003e [Optional]\n\n%timeoperate_\u003ctime\u003e_\u003cdisplay format\u003e[_\u003ctime override\u003e]%\n```\nType `{placeholder}` or `(placeholder)` if you want to use some placeholders in arguments.\n\n\u003e I am not a native English speaker. There are maybe some typo errors.\n\n## time\n| value                                                                                                    | detail                 | example                    |\n|----------------------------------------------------------------------------------------------------------|------------------------|----------------------------|\n| now                                                                                                      | now time               | `now`                      |\n| timestamp                                                                                                | timestamp (in seconds) | `1675353600`               |\n| [Formatter](http://docs.oracle.com/javase/8/docs/api/java/time/format/DateTimeFormatter.html)\u0026#124;value | specific format time   | yyyy-MM-dd\u0026#124;2023-02-03 |\n| LocalDateTime                                                                                            | use common format      | `2026-01-01 08:00:00`      |\n| LocalDateTime (ISO)                                                                                      | use ISO format         | `2026-01-01T08:00:00`      |\n| LocalDate                                                                                                | with `00:00:00` time   | `2026-01-01`               |\n| LocalTime                                                                                                | with now date          | `08:00:00`                 |\n\n## display format\n\nUse `unix` for returning timestamp (in seconds).\n\nOr read the [DateTimeFormatter](http://docs.oracle.com/javase/8/docs/api/java/time/format/DateTimeFormatter.html) Javadoc page about possible formats.  \ne.g. `yyyy-MM-dd` (2024-08-10), `HH:mm:ss` (11:45:14)\n\n## time override\n| value              | detail                                                                                                                                                                                                                                                                                                    | example                                                                 |\n|--------------------|-----------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------|-------------------------------------------------------------------------|\n| +DURATION          | plus time, needed number and unit (ignore case), \u003cul\u003e\u003cli\u003e`d` means **day(s)**\u003c/li\u003e\u003cli\u003e`h` means **hour(s)**\u003c/li\u003e\u003cli\u003e`m` means **minute(s)**\u003c/li\u003e\u003cli\u003e`s` means **second(s)**\u003c/li\u003e\u003c/ul\u003e                                                                                                                     | `+1d2h`                                                                 |\n| -DURATION          | minus time, needed number and unit (ignore case), \u003cul\u003e\u003cli\u003e`d` means **day(s)**\u003c/li\u003e\u003cli\u003e`h` means **hour(s)**\u003c/li\u003e\u003cli\u003e`m` means **minute(s)**\u003c/li\u003e\u003cli\u003e`s` means **second(s)**\u003c/li\u003e\u003c/ul\u003e                                                                                                                    | `-1d2h`                                                                 |\n| unit=value         | set specific time, needed unit and number (case sensitivity), \u003cul\u003e\u003cli\u003e`y` or `year` means **year**\u003c/li\u003e\u003cli\u003e`M` or `month` means **month**\u003c/li\u003e\u003cli\u003e`d` or `day` means **date**\u003c/li\u003e\u003cli\u003e`h` or `hour` means **hour**\u003c/li\u003e\u003cli\u003e`m` or `minute` means **minute**\u003c/li\u003e\u003cli\u003e`s` or `second` means **second**\u003c/ul\u003e | `y=2023`                                                                |\n| date=value         | set specific date, in ISO local date format                                                                                                                                                                                                                                                               | `date=2026-01-01`                                                       |\n| hour:minute:second | set hour, minute and second in a more simple way, type `~` means not modify                                                                                                                                                                                                                               | `4:0:0`, `6:0` (full `06:00:00`), `20:05` (full `20:05:00`), `11:45:14` |\n| w+num              | set date to next *num* weeks' Monday. If *num* equals 0, it just set date to the Monday of that week.                                                                                                                                                                                                     | `w+1` (`2024-11-15 Friday` -\u003e `2024-11-18 Monday`)                      |\n| w-num              | set date to previous *num* weeks' Monday. The same as `w+num`                                                                                                                                                                                                                                             | `w-1` (`2024-11-15 Friday` -\u003e `2024-11-04 Monday`)                      |\n| M+num              | just plus *num* months.                                                                                                                                                                                                                                                                                   | `M+1` (`2025-01-11` -\u003e `2025-02-11`)                                    |\n| M-num              | just minus *num* months.                                                                                                                                                                                                                                                                                  | `M-1` (`2025-01-11` -\u003e `2024-12-11`)                                    |\n| y+num              | just plus *num* years.                                                                                                                                                                                                                                                                                    | `y+1` (`2025-01-11` -\u003e `2026-01-11`)                                    |\n| y-num              | just minus *num* years.                                                                                                                                                                                                                                                                                   | `y-1` (`2025-01-11` -\u003e `2024-01-11`)                                    |\n\nSupport multi overrides, connect them with `_`.\n\n# Examples\n\n```\n// Get timestamp (in second) of tomorrow 6:00\n%timeoperate_now_unix_+1d_6:00%\n\n// Get time of tomorrow but minute and second are 0 with custom format\n%timeoperate_now_yyyy/MM/dd HH:mm:ss_+1d_~:0:0%\n```\n\n# Usage Examples\n\n```\n// give player temp permission by LuckPerms, expire in tomorrow 4:00\n/lp user %player_name% permission settemp your.perm.here true %timeoperate_now_unix_+1d_4:00%\n```\n","project_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fmrxiaom%2Ftimeoperate-expansion","html_url":"https://awesome.ecosyste.ms/projects/github.com%2Fmrxiaom%2Ftimeoperate-expansion","lists_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fmrxiaom%2Ftimeoperate-expansion/lists"}