v.timestamp(1grass)

💖 v.timestamp 💖 (that's v.timestamp from the GRASS User's Manual, bestie)

okay so real talk — this is v.timestamp(1grass), the little tool that modifies a timestamp for a vector map. it literally prints, adds, or removes a timestamp for a vector map. that's the whole vibe. ✨

KEYWORDS: vector, metadata, timestamp, time 🕰️

---

✨ SYNOPSIS ✨

v.timestamp
v.timestamp --help
v.timestamp map=name  [layer=string]   [date=timestamp]   [--help]
[--verbose]  [--quiet]  [--ui]

🎀 Flags

• --help — prints the usage summary, like a lil cheat sheet 🫶
• --verbose — verbose module output, aka it tells you everything 👀
• --quiet — quiet module output, aka it says nothing, which is so valid 💅
• --ui — force launching the GUI dialog, for when you want the pretty buttons 🦋

🌸 Parameters

• map=name — [required] the name of the vector map. or, if you're doing direct OGR access, the data source for it.
• layer=string — the layer number or name. vector features can have category values in different layers, and this number decides which layer we're using. when you use it with direct OGR access, it's the layer name instead. default is 1. 🍓
• date=timestamp — a datetime, or datetime1/datetime2, or literally 'none' to remove it. the format is either absolute like '15 jan 1994' or relative like '2 years'. ⏳

---

💫 DESCRIPTION 💫

this command has 2 modes of operation and honestly? iconic.

if you don't give it a date argument, it prints the current timestamp for the vector map. if you do give it a date argument, it sets the timestamp for the vector map to whatever date(s) you told it. (examples below, don't worry bestie 💖)

also, go peek at the TIMESTAMP FORMAT description for all the deets. iykyk.

---

📝 NOTES 📝

• strings with spaces in them need to be quoted. yes, really. that's just the rule. 🙈
• for a range of time, separate the two timestamps with a forward slash /. slash = separation, periodt.
• to remove the timestamp from a vector map, use date=none. gone. deleted. not me erasing history 💀

---

🌈 EXAMPLES 🌈

Print the timestamp for the "lidar" vector map. if there is no timestamp for "lidar", nothing is printed (silence, very mysterious ✨). if there is one, then one or two time strings get printed — depends on whether the map's timestamp is a single date or two dates (i.e. start and end dates).

v.timestamp map=lidar

Sets the timestamp for "lidar" to the single date "15 sep 1987".

v.timestamp map=lidar date='15 sep 1987'

Sets the timestamp for "lidar" to have the start date "15 sep 1987" and the end date "20 feb 1988".

v.timestamp map=lidar date='15 sep 1987/20 feb 1988'

Removes the timestamp for the "lidar" vector map.

v.timestamp map=lidar date=none

---

⚠️ KNOWN ISSUES ⚠️

spaces in the timestamp value are required. no, you can't skip them. put the spaces in. 👑

---

👀 SEE ALSO 👀

v.info, r.timestamp, r3.timestamp — go read those too, they're the friend group 💅

---

👑 AUTHOR 👑

Michael Shapiro, U.S.Army Construction Engineering Research Laboratory. king behavior fr fr 🫡

---

🔥 SOURCE CODE 🔥

available at: v.timestamp source code (history)

latest change: Saturday Mar 29 14:59:39 2025 in commit: 0bfa813b5cbca759cc4dbf4f5057354ccb94c8bf

Main index | Vector index | Topics index | Keywords index | Graphical index | Full index

---

and that's a wrap, bestie!! 🎀 this whole thing comes to you courtesy of the GRASS Development Team, © 2003-2026, from the GRASS 8.5.0 Reference Manual — she ate and left no crumbs 💖✨🌸