NEST 中的時間單位

来源:https://www.cnblogs.com/WessonStar/archive/2018/01/18/8312804.html
-Advertisement-
Play Games

這篇文章介紹了 NEST 中是如何實現 Elasticsearch 中的時間段的 ...


Time units

Version: 5.x

英文原文地址:Time units

與 Elasticsearch 交互,我們會遇到需要設定時間段的情況(例如:timeout 參數)。為了指定時間段,我們可以使用一個表示時間的整數(以毫秒為單位),也可以使用一個時間值(例如:2d 表示 2 天)。

NEST 使用一個 Time 類型來滿足上述需求,有好幾種方式來構造 Time 對象。

Constructor

最直接的方式當然是構造函數了,參數可以是列表中的任意一種:

  • 字元串
  • double 類型的毫秒值
  • 因數和間隔的組合(其實就是數字和單位)
  • TimeSpan 對象
var unitString = new Time("2d");
var unitComposed = new Time(2, Nest.TimeUnit.Day);
var unitTimeSpan = new Time(TimeSpan.FromDays(2));
var unitMilliseconds = new Time(1000 * 60 * 60 * 24 * 2);

Time 對象序列化後的結果是一個由因數和間隔構成的字元串,如:上面這段代碼中的變數序列化的結果都是 2d

即使沒有使用 Time(double ms) 這個構造函數,TimeMilliseconds 屬性也會被計算。

unitMilliseconds.Milliseconds.Should().Be(1000*60*60*24*2);
unitComposed.Milliseconds.Should().Be(1000*60*60*24*2);
unitTimeSpan.Milliseconds.Should().Be(1000*60*60*24*2);
unitString.Milliseconds.Should().Be(1000*60*60*24*2);

Implicit conversion

NEST 提供了從 string TimeSpan doubleTime 的隱式轉換,提高了易用性。

Time oneAndHalfYear = "1.5y";
Time fourteenDays = TimeSpan.FromDays(14);
Time twoDays = 1000*60*60*24*2;

Expect("1.5y").WhenSerializing(oneAndHalfYear);
Expect("14d").WhenSerializing(fourteenDays);
Expect("2d").WhenSerializing(twoDays);

Equality and Comparison

處理 年和月 的時候,是無法精確計算毫秒數的,Milliseconds 的值為 -1 。這是因為年和月不是固定的值,舉個慄子

  • 一月(不是一月份)可能有 30 天、31 天、28 天、29 天
  • 一年可能有 365 天、366 天
Time oneAndHalfYear = "1.5y";
oneAndHalfYear.Milliseconds.Should().Be(-1);

你可以將兩個 Time 對象做比較

Time twoDays = 1000*60*60*24*2;

oneAndHalfYear.Should().BeGreaterThan(fourteenDays);
(oneAndHalfYear > fourteenDays).Should().BeTrue();
(oneAndHalfYear >= fourteenDays).Should().BeTrue();
(twoDays != null).Should().BeTrue();
(twoDays >= new Time("2d")).Should().BeTrue();

twoDays.Should().BeLessThan(fourteenDays);
(twoDays < fourteenDays).Should().BeTrue();
(twoDays <= fourteenDays).Should().BeTrue();
(twoDays <= new Time("2d")).Should().BeTrue();

判定相等性

twoDays.Should().Be(new Time("2d"));
(twoDays == new Time("2d")).Should().BeTrue();
(twoDays != new Time("2.1d")).Should().BeTrue();
(new Time("2.1d") == new Time(TimeSpan.FromDays(2.1))).Should().BeTrue();

相等的精確度為 0.1 納秒

Time oneNanosecond = new Time(1, Nest.TimeUnit.Nanoseconds);
Time onePointNoughtNineNanoseconds = "1.09nanos";
Time onePointOneNanoseconds = "1.1nanos";

(oneNanosecond == onePointNoughtNineNanoseconds).Should().BeTrue();
(oneNanosecond == onePointOneNanoseconds).Should().BeFalse();

Special Time Values

Elasticsearch 有兩個特殊的時間值

  • 0 通過 Time.Zero 表示
  • -1 通過 Time.MinusOne 表示

下麵的對象都等於 Time.MinusOne

Time.MinusOne.Should().Be(Time.MinusOne);
new Time("-1").Should().Be(Time.MinusOne);
new Time(-1).Should().Be(Time.MinusOne);
((Time) (-1)).Should().Be(Time.MinusOne);
((Time) "-1").Should().Be(Time.MinusOne);
((Time) (-1)).Should().Be((Time) "-1");

下麵的對象都等於 Time.Zero

Time.Zero.Should().Be(Time.Zero);
new Time("0").Should().Be(Time.Zero);
new Time(0).Should().Be(Time.Zero);
((Time) 0).Should().Be(Time.Zero);
((Time) "0").Should().Be(Time.Zero);
((Time) 0).Should().Be((Time) "0");

特殊的時間值 0-1 可以和其他 Time 值做比較,儘管這看起來很荒謬。

var twoDays = new Time(2, Nest.TimeUnit.Day);
Time.MinusOne.Should().BeLessThan(Time.Zero);
Time.Zero.Should().BeGreaterThan(Time.MinusOne);
Time.Zero.Should().BeLessThan(twoDays);
Time.MinusOne.Should().BeLessThan(twoDays);

如果需要構造一個 -1ms 或者 0ms 的時間,使用接收因數和間隔的構造函數,或者指定一個 ms 字元串

(new Time(-1, Nest.TimeUnit.Millisecond) == new Time("-1ms")).Should().BeTrue();
(new Time(0, Nest.TimeUnit.Millisecond) == new Time("0ms")).Should().BeTrue();

Units of Time

可以使用一個 DateIntervalTime 構成的共用體 Union<DateInterval, Time> 來指定一個 Time 的單位,它支持 TimeDateInterval 的隱式轉換

Expect("month").WhenSerializing<Union<DateInterval, Time>>(DateInterval.Month);
Expect("day").WhenSerializing<Union<DateInterval, Time>>(DateInterval.Day);
Expect("hour").WhenSerializing<Union<DateInterval, Time>>(DateInterval.Hour);
Expect("minute").WhenSerializing<Union<DateInterval, Time>>(DateInterval.Minute);
Expect("quarter").WhenSerializing<Union<DateInterval, Time>>(DateInterval.Quarter);
Expect("second").WhenSerializing<Union<DateInterval, Time>>(DateInterval.Second);
Expect("week").WhenSerializing<Union<DateInterval, Time>>(DateInterval.Week);
Expect("year").WhenSerializing<Union<DateInterval, Time>>(DateInterval.Year);

Expect("2d").WhenSerializing<Union<DateInterval, Time>>((Time)"2d");
Expect("11664m").WhenSerializing<Union<DateInterval, Time>>((Time)TimeSpan.FromDays(8.1));

您的分享是我們最大的動力!

-Advertisement-
Play Games
更多相關文章
  • 文章參考:https://www.cnblogs.com/wangfuyou/p/6046307.html 1.解決辦法是在web.config增加如下節點到<configuration>下 <system.web.extensions> <scripting> <webServices> <jso ...
  • 方法中調用了其它dll沒有做異常捕獲的處理的方法,即使在本代碼用使用try,cath做異常捕獲,這樣也捕獲不了, 此時需要在本方法頭上使用如下引用即可捕獲到異常: ...
  • 由於精力有限,博主現在只維護這一個系統,會不時的更新代碼提交。 “”小魚企業級開發系統“”的Svn地址:http://code.taobao.org/svn/SF_EDS 項目截圖: 這裡簡單說下系統(字數不夠不讓推首頁。。) 系統的Ioc使用的Spring.Net,MVC框架是微軟自帶的MVC框架 ...
  • "回到目錄" 任務調度組件 1. 位於Scheduling目錄 2. 基類JobBase,所有JOB都派生自它,重寫Cron屬性可以修改調度周期 3. 支持單次JOB,即執行完成後馬上停止 4. 支持對外API介面,以便獲取和修改JOB的列表的狀態 源代碼展現 自定義Job在繼承JobBase之後, ...
  • 繼上文<<基於阻塞隊列的生產者消費者C#併發設計>>的併發隊列版本的併發設計,原文code是基於<<.Net中的並行編程-4.實現高性能非同步隊列>>修改過來的,前面的幾篇文章也詳細介紹了併發實現的其它方案及實現。直接給code: 調用code: 併發系列應該就這樣完了,回頭整理成目錄,自己查起來也方 ...
  • 原文地址:https://www.cnblogs.com/pipi-changing/p/5697481.html 找了下Cron的資料,這篇作者寫的比較清晰,轉載記錄一下,方便後面使用的時候在google 1. cron表達式格式: {秒數} {分鐘} {小時} {日期} {月份} {星期} {年... ...
  • 昨天,在做一個NPOI讀取的小demo的時候,使用OpenFileDialog打開文件,最開始的寫法,直接在按鈕點擊事件中寫,會報錯,代碼如下: 或者直接 這兩種,無論哪種寫法,在代碼執行的時候,會報錯,具體報錯為: 這種情況,在網上查詢,是說線程問題,就是線程衝突了,不知道該執行哪一個,具體說法如 ...
  • 本篇文章更適合具有一定開發經驗,一定功底,且對底層代碼有所研究的朋友!!! 本篇文章主要採用理論和代碼實例相結合方式來論述委托和事件,涉及到一些邊界技術,如軟體架構的OCP原則(開-閉原則), 軟體架構解耦,設計模式(Sender-Order)和事件驅動模型,有一定難度和深度,不適合初級者。 第一部 ...
一周排行
    -Advertisement-
    Play Games
  • Timer是什麼 Timer 是一種用於創建定期粒度行為的機制。 與標準的 .NET System.Threading.Timer 類相似,Orleans 的 Timer 允許在一段時間後執行特定的操作,或者在特定的時間間隔內重覆執行操作。 它在分散式系統中具有重要作用,特別是在處理需要周期性執行的 ...
  • 前言 相信很多做WPF開發的小伙伴都遇到過表格類的需求,雖然現有的Grid控制項也能實現,但是使用起來的體驗感並不好,比如要實現一個Excel中的表格效果,估計你能想到的第一個方法就是套Border控制項,用這種方法你需要控制每個Border的邊框,並且在一堆Bordr中找到Grid.Row,Grid. ...
  • .NET C#程式啟動閃退,目錄導致的問題 這是第2次踩這個坑了,很小的編程細節,容易忽略,所以寫個博客,分享給大家。 1.第一次坑:是windows 系統把程式運行成服務,找不到配置文件,原因是以服務運行它的工作目錄是在C:\Windows\System32 2.本次坑:WPF桌面程式通過註冊表設 ...
  • 在分散式系統中,數據的持久化是至關重要的一環。 Orleans 7 引入了強大的持久化功能,使得在分散式環境下管理數據變得更加輕鬆和可靠。 本文將介紹什麼是 Orleans 7 的持久化,如何設置它以及相應的代碼示例。 什麼是 Orleans 7 的持久化? Orleans 7 的持久化是指將 Or ...
  • 前言 .NET Feature Management 是一個用於管理應用程式功能的庫,它可以幫助開發人員在應用程式中輕鬆地添加、移除和管理功能。使用 Feature Management,開發人員可以根據不同用戶、環境或其他條件來動態地控制應用程式中的功能。這使得開發人員可以更靈活地管理應用程式的功 ...
  • 在 WPF 應用程式中,拖放操作是實現用戶交互的重要組成部分。通過拖放操作,用戶可以輕鬆地將數據從一個位置移動到另一個位置,或者將控制項從一個容器移動到另一個容器。然而,WPF 中預設的拖放操作可能並不是那麼好用。為瞭解決這個問題,我們可以自定義一個 Panel 來實現更簡單的拖拽操作。 自定義 Pa ...
  • 在實際使用中,由於涉及到不同編程語言之間互相調用,導致C++ 中的OpenCV與C#中的OpenCvSharp 圖像數據在不同編程語言之間難以有效傳遞。在本文中我們將結合OpenCvSharp源碼實現原理,探究兩種數據之間的通信方式。 ...
  • 一、前言 這是一篇搭建許可權管理系統的系列文章。 隨著網路的發展,信息安全對應任何企業來說都越發的重要,而本系列文章將和大家一起一步一步搭建一個全新的許可權管理系統。 說明:由於搭建一個全新的項目過於繁瑣,所有作者將挑選核心代碼和核心思路進行分享。 二、技術選擇 三、開始設計 1、自主搭建vue前端和. ...
  • Csharper中的表達式樹 這節課來瞭解一下表示式樹是什麼? 在C#中,表達式樹是一種數據結構,它可以表示一些代碼塊,如Lambda表達式或查詢表達式。表達式樹使你能夠查看和操作數據,就像你可以查看和操作代碼一樣。它們通常用於創建動態查詢和解析表達式。 一、認識表達式樹 為什麼要這樣說?它和委托有 ...
  • 在使用Django等框架來操作MySQL時,實際上底層還是通過Python來操作的,首先需要安裝一個驅動程式,在Python3中,驅動程式有多種選擇,比如有pymysql以及mysqlclient等。使用pip命令安裝mysqlclient失敗應如何解決? 安裝的python版本說明 機器同時安裝了 ...