সূচক
তারিখ
একটি পূর্ণাঙ্গ বা আংশিক ক্যালেন্ডার তারিখ প্রতিনিধিত্ব করে, যেমন জন্মদিন। দিনের সময় এবং সময় অঞ্চল হয় অন্য কোথাও নির্দিষ্ট করা আছে অথবা তাৎপর্যপূর্ণ নয়। তারিখটি গ্রেগরিয়ান ক্যালেন্ডারের সাথে সম্পর্কিত। এটি নিম্নলিখিতগুলির মধ্যে একটি প্রতিনিধিত্ব করতে পারে:
- একটি পূর্ণ তারিখ, যেখানে বছর, মাস এবং দিনের মান শূন্য নয়।
- একটি মাস এবং একটি দিন, যেখানে একটি শূন্য বছর (উদাহরণস্বরূপ, একটি বার্ষিকী)।
- একটি শূন্য মাস এবং একটি শূন্য দিন সহ একটি নিজস্ব বছর।
- একটি বছর এবং একটি মাস, শূন্য দিন সহ (উদাহরণস্বরূপ, একটি ক্রেডিট কার্ডের মেয়াদ শেষ হওয়ার তারিখ)।
সম্পর্কিত প্রকার:
-
google.type.TimeOfDay -
google.type.DateTime -
google.protobuf.Timestamp
| ক্ষেত্র | |
|---|---|
year | তারিখের বছর। ১ থেকে ৯৯৯৯ পর্যন্ত হতে হবে, অথবা বছর ছাড়া তারিখ উল্লেখ করতে ০ হতে হবে। |
month | বছরের মাস। ১ থেকে ১২ পর্যন্ত হতে হবে, অথবা মাস এবং দিন ছাড়া বছর নির্দিষ্ট করতে ০ হতে হবে। |
day | মাসের দিন। ১ থেকে ৩১ পর্যন্ত হতে হবে এবং বছর এবং মাসের জন্য বৈধ হতে হবে, অথবা একটি বছর নির্দিষ্ট করার জন্য ০ হতে হবে, অথবা এমন একটি বছর এবং মাস যেখানে দিনটি গুরুত্বপূর্ণ নয়। |
তারিখ সময়
সিভিল টাইম (অথবা মাঝে মাঝে ভৌত সময়) প্রতিনিধিত্ব করে।
এই ধরণটি কয়েকটি সম্ভাব্য উপায়ের একটিতে একটি সিভিল সময়কে উপস্থাপন করতে পারে:
- যখন utc_offset সেট করা থাকে এবং time_zone সেট না করা থাকে: UTC থেকে একটি নির্দিষ্ট অফসেট সহ একটি ক্যালেন্ডার দিনে একটি সিভিল সময়।
- যখন time_zone সেট করা থাকে এবং utc_offset সেট না করা থাকে: একটি নির্দিষ্ট সময় অঞ্চলে একটি ক্যালেন্ডার দিনে একটি সিভিল সময়।
- যখন time_zone বা utc_offset কোনটিই সেট করা থাকে না: স্থানীয় সময়ে একটি ক্যালেন্ডার দিনে একটি সিভিল সময়।
তারিখটি প্রোলেপটিক গ্রেগরিয়ান ক্যালেন্ডারের সাথে সম্পর্কিত।
যদি বছর, মাস, অথবা দিন ০ হয়, তাহলে DateTime-এর যথাক্রমে কোন নির্দিষ্ট বছর, মাস, অথবা দিন নেই বলে বিবেচিত হবে।
এই ধরণটি একটি ভৌত সময় প্রতিনিধিত্ব করার জন্যও ব্যবহার করা যেতে পারে যদি সমস্ত তারিখ এবং সময় ক্ষেত্র সেট করা থাকে এবং time_offset এর যেকোনো একটি ক্ষেত্রে সেট করা থাকে। পরিবর্তে ভৌত সময়ের জন্য Timestamp বার্তা ব্যবহার করার কথা বিবেচনা করুন। যদি আপনার ব্যবহারের ক্ষেত্রে ব্যবহারকারীর টাইমজোন সংরক্ষণ করতে চান, তাহলে এটি অন্য ক্ষেত্রেও করা যেতে পারে।
এই ধরণের অ্যাপ্লিকেশনটি কিছু অ্যাপ্লিকেশনের চেয়ে বেশি নমনীয়। আপনার অ্যাপ্লিকেশনের সীমাবদ্ধতাগুলি নথিভুক্ত এবং যাচাই করতে ভুলবেন না।
| ক্ষেত্র | |
|---|---|
year | ঐচ্ছিক। তারিখের বছর। ১ থেকে ৯৯৯৯ পর্যন্ত হতে হবে, অথবা যদি বছর ছাড়া তারিখের সময় উল্লেখ করা হয় তবে ০ হতে হবে। |
month | ঐচ্ছিক। বছরের মাস। ১ থেকে ১২ পর্যন্ত হতে হবে, অথবা মাস ছাড়া তারিখ-সময় উল্লেখ করলে ০ হতে হবে। |
day | ঐচ্ছিক। মাসের দিন। ১ থেকে ৩১ তারিখ পর্যন্ত হতে হবে এবং বছর এবং মাসের জন্য বৈধ হতে হবে, অথবা যদি দিন ছাড়া তারিখ-সময় উল্লেখ করা হয় তবে ০ হতে হবে। |
hours | ঐচ্ছিক। দিনের সময় ২৪ ঘন্টার ফর্ম্যাটে। ০ থেকে ২৩ এর মধ্যে হওয়া উচিত, ডিফল্ট ০ (মধ্যরাত)। ব্যবসা বন্ধের সময় এর মতো পরিস্থিতিতে একটি API "২৪:০০:০০" মানটি মঞ্জুর করতে পারে। |
minutes | ঐচ্ছিক। দিনের ঘন্টার মিনিট। ০ থেকে ৫৯ এর মধ্যে হতে হবে, ডিফল্ট ০। |
seconds | ঐচ্ছিক। সময়ের মিনিটের সেকেন্ড। সাধারণত ০ থেকে ৫৯ এর মধ্যে হতে হবে, ডিফল্ট ০। একটি API যদি লিপ-সেকেন্ডের অনুমতি দেয় তবে মান ৬০ মঞ্জুর করতে পারে। |
nanos | ঐচ্ছিক। ন্যানোসেকেন্ডে সেকেন্ডের ভগ্নাংশ। ০ থেকে ৯৯৯,৯৯৯,৯৯৯ হতে হবে, ডিফল্ট ০। |
Union ফিল্ড time_offset । ঐচ্ছিক। UTC অফসেট অথবা DateTime এর সময় অঞ্চল নির্দিষ্ট করে। ভবিষ্যতে সময় অঞ্চলের ডেটা পরিবর্তন হতে পারে তা বিবেচনা করে সাবধানতার সাথে তাদের মধ্যে নির্বাচন করুন (উদাহরণস্বরূপ, একটি দেশ তাদের DST শুরু/শেষ তারিখ পরিবর্তন করে, এবং প্রভাবিত পরিসরে ভবিষ্যতের DateTimes ইতিমধ্যেই সংরক্ষণ করা হয়েছে)। যদি বাদ দেওয়া হয়, তাহলে DateTime স্থানীয় সময়ে বিবেচিত হবে। time_offset নিম্নলিখিতগুলির মধ্যে শুধুমাত্র একটি হতে পারে: | |
utc_offset | UTC অফসেট। -১৮ ঘন্টা থেকে +১৮ ঘন্টার মধ্যে পুরো সেকেন্ড হতে হবে। উদাহরণস্বরূপ, -৪:০০ এর একটি UTC অফসেট { সেকেন্ড: -১৪৪০০ } হিসাবে উপস্থাপন করা হবে। |
time_zone | সময় অঞ্চল। |
ব্যবধান
একটি সময় ব্যবধান প্রতিনিধিত্ব করে, যা টাইমস্ট্যাম্প শুরু (সমেত) এবং টাইমস্ট্যাম্প শেষ (এক্সক্লুসিভ) হিসাবে এনকোড করা থাকে।
শুরু অবশ্যই শেষের চেয়ে কম বা সমান হতে হবে। যখন শুরু শেষের সমান হয়, তখন ব্যবধানটি খালি থাকে (কোনও সময়ের সাথে মেলে না)। যখন শুরু এবং শেষ উভয়ই নির্দিষ্ট না থাকে, তখন ব্যবধানটি যেকোনো সময়ের সাথে মেলে।
| ক্ষেত্র | |
|---|---|
start_time | ঐচ্ছিক। বিরতির অন্তর্ভুক্তিমূলক শুরু। যদি নির্দিষ্ট করা থাকে, তাহলে এই ব্যবধানের সাথে মিলে যাওয়া একটি টাইমস্ট্যাম্প একই হতে হবে অথবা শুরুর পরে হতে হবে। |
end_time | ঐচ্ছিক। বিরতির একচেটিয়া সমাপ্তি। যদি নির্দিষ্ট করা থাকে, তাহলে এই ব্যবধানের সাথে মিলে যাওয়া একটি টাইমস্ট্যাম্প শেষের আগে হতে হবে। |
অক্ষাংশ
একটি বস্তু যা একটি অক্ষাংশ/দ্রাঘিমাংশ জোড়া প্রতিনিধিত্ব করে। এটি ডিগ্রি অক্ষাংশ এবং ডিগ্রি দ্রাঘিমাংশ প্রতিনিধিত্ব করার জন্য দ্বিগুণের জোড়া হিসাবে প্রকাশ করা হয়। অন্যথায় নির্দিষ্ট না করা হলে, এই বস্তুটিকে WGS84 মান মেনে চলতে হবে। মানগুলি স্বাভাবিক সীমার মধ্যে থাকতে হবে।
| ক্ষেত্র | |
|---|---|
latitude | ডিগ্রীতে অক্ষাংশ। এটি অবশ্যই [-৯০.০, +৯০.০] পরিসরে হতে হবে। |
longitude | ডিগ্রীতে দ্রাঘিমাংশ। এটি অবশ্যই [-১৮০.০, +১৮০.০] পরিসরে হতে হবে। |
স্থানীয়করণকৃত পাঠ্য
একটি নির্দিষ্ট ভাষার একটি পাঠ্যের স্থানীয় রূপ।
| ক্ষেত্র | |
|---|---|
text | নিচের |
language_code | টেক্সটের BCP-47 ভাষা কোড, যেমন "en-US" বা "sr-Latn"। আরও তথ্যের জন্য, http://www.unicode.org/reports/tr35/#Unicode_locale_identifier দেখুন। |
টাইমজোন
IANA টাইম জোন ডাটাবেস থেকে একটি টাইম জোন প্রতিনিধিত্ব করে।
| ক্ষেত্র | |
|---|---|
id | IANA টাইম জোন ডাটাবেস টাইম জোন। উদাহরণস্বরূপ "আমেরিকা/নিউইয়র্ক"। |
version | ঐচ্ছিক। IANA টাইম জোন ডাটাবেস সংস্করণ নম্বর। উদাহরণস্বরূপ "2019a"। |